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MANUAL OBJECTIVES 
This manual: 

• introduces RT-11/FEP and RT-11/FRP — the FORTRAN Enhancement 
Package and the FORTRAN Real-Time Package that include the RT-11 
operating system, the FORTRAN IV programming language, and the 
FEP/FRP Laboratory Software 

• guides you through the procedures for installing RT-11, FORTRAN IV, 
and the FEP/FRP Laboratory Software 

• describes ways to manage disk storage efficiently 

• introduces program-development techniques 

INTENDED READER 

The reader of this manual should be a FORTRAN programmer experienced 
in scientific applications. The reader need not be familiar with the RT-11 
operating system or the FEP/FRP Laboratory Software. 

MANUAL STRUCTURE 

Part I of this manual, the introduction, contains Chapter 1, an overview of 
the hardware, software, and documentation. 

Part II contains three chapters on installing software. Chapter 2 is a guide 
to installing the RT-11 operating system. Chapter 3 is a guide to installing 
the FORTRAN IV programming language. Chapter 4 gives instructions for 
installing the FEP/FRP Laboratory Software subprograms. 

Part III contains four chapters on using the software. Chapter 5 presents 
program development techniques. Chapter 6 describes restrictions to be 
observed in the use of the REAL-11/MNC software. Chapter 7 contains 
information on using the RGL/11 software. Chapter 8 provides information 
on using the PLOT55 video graphics software. 
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RELATED DOCUMENTS 

For information on related documents in the RT-11 documentation library, 
consult the RT-11 Documentation Directory AA-5285E-TC. 

For information on the FORTRAN IV programming language, consult: 

PDP-11 FORTRAN Language Reference Manual 
AA-1855D-TC 

RT-11, RSTSIE FORTRAN IV User's Guide 
AA-5749B-TC 

RT-11 FORTRAN IV Installation Guide 
AA-5240D-TC 

For information concerning FEP/FRP software, consult: 

REAL-lllMNC FORTRAN Programmer's Reference Manual 
AA-D631B-TC 

Scientific Subroutines Programmer's Reference Manual 
AA-llOlC-TC 

Instrument Bus Subroutines Programmer's Reference Manual 
AA-5613B-TC 

Laboratory Subroutines Programmer's Reference Manual 
AA-C984B-TC 

FORTRAN Debugging Technique Reference Manual 
AA-H069B-TC 

RGLIll Programmer's Reference Manual 
AA-K783A-TC 

For information concerning hardware, consult: 

DECLAB-lllMNC User's Guide 
EK-MNCll-UG 

MINC Thermocouple Preamplifier User's Guide 
EK-MNCTP-UG 

VT125 User's Guide 
EK-VT125-UG-001 

VT105 Graphic Terminal User's Manual 
EK-VT105-UG 

DOCUMENTATION CONVENTIONS 

This manual conforms to the following documentation conventions: 

• In examples of terminal-programmer dialog, text printed in red indicates 
your input to the system. Text printed in black indicates responses sup- 
plied by the system. 



• (H) indicates the RETURN key on your terminal. Press the RETURN key 
at the end of any line you type unless instructed otherwise. 

• [ NO SCROLL] indicates the NO SCROLL key on your video terminal. 



• [CTRL/x ) represents the CTRL key and another key (represented here by x) 
on your terminal. To perform some functions, you must press the CTRL 
key and the other key at the same time. 



• (SHFT/x ) represents the shift key and another key. 

• In descriptions of command syntax, capital letters represent the com- 
mand name, which you must type. Lower case letters represent a vari- 
able, for which you must supply a value. 

Square brackets [ ] enclose optional choices; you can include an item in 
brackets, or you can omit it, as you choose. 

The ellipsis symbol (...) represents repetition. You can repeat the item 
that precedes the ellipsis. 

• RL01/RL02 indicates either an RLOl or RL02 disk. 

• Unless otherwise noted, all programs are on drive DK:. 

• References to the FB environment also apply to the XM environment, 
unless otherwise stated. 
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Parti 
Introduction 



Part I is an overview of the hardware, software, and documentation. 



Chapter 1 

Hardware and Software Overview 



This chapter introduces the hardware, software and software documenta- 
tion. The hardware is from the MINC family (MINC-11, MINC-23, or 
MINC/DECLAB23). The software consists of the RT-11 operating system, 
the FORTRAN IV programming language, and the components of the 
FEP/FRP Laboratory Software. The software documentation includes sets 
of manuals on RT-11, FORTRAN IV, and the FEP/FRP Laboratory 
Software. 

1.1 Hardware 

Your hardware includes the following hardware components: 

• a PDP 11/03 processor (with the FIS floating-point hardware) or a 
PDP 11/23 processor (with the FPU floating-point hardware) 

• at least 56k (k = 1,024) bytes of random-access memory 

• at least one video or hard-copy terminal (See Section 5.1 for information 
about terminals.) 

• a chassis that can contain up to eight MNC modules 

Your hardware also includes either two RL01/RL02 disk drives or two 
RX02 diskette drives. RLOl and RL02 disks have a much greater storage 
capacity than RX02 diskettes. An RLOl disk can store 5.2 million bytes of 
data, and an RL02 disk can store over 10 million bytes. However, an RX02 
can store only 512,512 bytes. 

This difference in capacity determines how you can use your disk storage. 
One RLOl or RL02 disk is large enough to store all of your software. How- 
ever, two or more RX02 diskettes together are required to store the same 
software. Many sections of this manual include one discussion related to 
RL01/RL02 disks and another discussion related to RX02 diskettes. 
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Software installation, generation, and program development procedures 
are performed one way on RL01/RL02 disks and another way on RX02 
diskettes. 

1.2 Software 

Your FEP/FRP software includes the RT-11 operating system, the 
FORTRAN IV programming language, and the following groups of 
FORTRAN-callable subprograms, which compose the FEP/FRP Laboratory 
Software: 

• REAL-11/MNC, which provides real-time control of all MNC-series mod- 
ules and the serial-ASCII transfer controller 

• IBS, the Instrument Bus Subroutines, which control IEEE bus 
instruments 

• SSP, the Scientific Subroutine Package, which performs mathematical 
data manipulations such as matrix inversions 

• LSP, the Laboratory Subroutine Package, which performs signal data 
processing such as Fast Fourier transforms 

• RGL/11, the ReGIS Graphics Library for FEP Users, which draws figures 
and plots data on the VT125 terminal (not available with the FRP 
package). 

• FDT, the FORTRAN Debugging Technique, which is an on-line debug- 
ging tool 

1.3 Hardware Requirements 

You must have particular hardware to execute some FEP/FRP components. 

• To execute REAL^ll/MNC subprograms, you must have the MNC-series 
module(s) needed by the subprogram(s) you will use. 

• To execute IBS subprograms, you must have an IBVll-A IEEE bus and 
at least one instrument that is compatible with the IBVll-A IEEE bus. 

• To execute the RGL/11 subprograms, you must have a VT125 video 
terminal. 

• To execute the remaining FEP/FRP components — SSP, LSP, and FDT — 
you need only standard MINC-family hardware. 

1.4 Distribution Media 

If you have two RLOl or RL02 disk drives, your software has been distrib- 
uted to you on three disk packs. If you have only RX02 diskette drives, your 
software has been distributed to you on 19 diskettes; some of these disk- 
ettes are in RXOl (single density) format while others are in RX02 (double 
density) format. See Table 1-1, Software Distribution Media, for the types 
of disks on which each software component is distributed. 
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Table 1-1: Software Distribution Media (RX01/RX02 or RL01/RL02) 

The numbers indicate disks required to store each software component 



Type of Disk 


RT-11 


FORTRAN IV 


REAI^ll 


IBS 


SSP 


LSP 


RGL/11 


FDT 


RXOl 




3 




1 


2 


1 




1 


RX02 


5 




2 








4 




RL01/RL02 


1 


1 


1 



1.5 Installing Software 

Install your software in the following sequence: 

1. RT-11 installation (and system generation if necessary) 

2. FORTRAN IV compiler and OTS (Object Time System) installation and 
generation 

3. FEP/FRP component installation 

Part II of this manual guides you through both the installation procedures 
and the documentation for each software component. 

1.6 Standard Software 

Some software components are shipped in standard form and are ready to 
use when you receive them. However, you can also configure much of the 
software to fit your particular needs. 

The RT-11 distribution media contain standard monitors as well as pro- 
grams for creating specialized monitors. Read Chapter 2 of this manual to 
determine whether or not you should customize your system and/or execute 
the system-generation (SYSGEN) procedure. 

The FORTRAN IV distribution disk contains a prebuilt FORTRAN IV com- 
piler and object-time system (OTS) as well as programs for generating a 
customized compiler and OTS. You must execute the FORTRAN generation 
procedure to utilize your floating-point hardware. (The prebuilt FORTRAN 
performs multiplication, division, and floating-point arithmetic with soft- 
ware routines. Therefore, the prebuilt FORTRAN IV performs some arith- 
metic operations much more slowly than FORTRAN IV, which utilizes 
floating-point hardware.) 

The FEP/FRP Laboratory Software distribution disks contain standard ver- 
sions of all FEP/FRP Laboratory Software. You can also customize all 
FEP/FRP Laboratory Software except FDT. For information on installing 
and customizing FEP/FRP, see Chapter 4 of this manual. 



1.7 Software Documentation 



For a list of manuals that describe the software, see Related Documents in 
the Preface. 
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Part II 

Installing Software 



The software consists of RT-11, FORTRAN IV, and FEP/FRP and must be 
installed in that order. (Figure 2-1, Installing Software, provides an over- 
view of the procedure for installing software.) 

Part II contains detailed instructions for installing RT-11 and the 
FEP/FRP Laboratory Software but is only a guide to FORTRAN IV instal- 
lation. This part of the manual also describes the order in which you must 
read RT-11 and FORTRAN IV installation manuals and contains informa- 
tion that supplements those manuals. 



Chapter 2 
Installing RT-11 



For FEP/FRP users, the major steps in the RT-11 installation pro- 
cedure are: 

1. Preparing for installation 

2. Using the FEP or FRP Installation Disk to create a development sys- 
tem disk 

3. Creating other system disks (optional) 

4. Customizing the system (optional) 

5. Testing the development system disk 

6. Performing the system-generation process (optional) 

Figure 2-1 is a diagram of the installation overview, and Figure 2-2 is a 
flowchart of the steps in the procedure for installing RT-11. Note that the 
procedure includes three optional steps, which are creating other system 
disks, customizing the system, and performing the system-generation pro- 
cess. This chapter explains the procedure for installing RT-11 and helps 
you decide which optional steps to execute. (Note that while this chapter 
fully describes some steps in the procedure — those not found in other 
manuals — the chapter also directs you to RT-11 manuals for more com- 
plete descriptions of other steps.) 

The installation procedures discussed in this chapter are the same for FEP 
and FRP. Therefore, only FEP examples are presented. 
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Figure 2-1: Installing Software 
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Figure 2-2: Installing RT-11 
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2.1 Preparing to Install RT-11 

Prior to installing RT-11: 

• Gather the following: 

RT-11 Installation and System Generation Guide 

RT-11 Autopatch Kit 

RT-11 distribution media 

Three blank RL01/RL02 disks or eleven blank RX02 diskettes 

• If you have two RL01/RL02 disk drives, power on the MINC computer 
system by following the instructions in Section 2.2, Operating 
Procedures, in the DECLAB-11/MNC User's Guide and mount the FEP 
distribution disk in drive 0. 

If you have only RX02 diskette drives, power on the computer system by 
executing the following procedures: 

1. Mount the FEP Installation Diskette in drive 0. 

2. Set the terminal's ON/OFF switch to the ON position. 

3. Power on the processor by pressing the red switch above drive 1, and 
be sure the light in the switch is lit. 

Regardless of which type of disks you have, once you have powered on the 
processor, the system automatically bootstraps RT-11 and displays on 
your terminal: 

RT-ll/FEP VZ.l 

Welcome to RT-ll/FEP version 2.1. 

(followed by startup file commands and additional messages. If you have 
two RL01/RL02 disk drives, see Section 2.2.1 for a list of these additional 
messages; if you have only RX02 diskette drives, see Section 2.3.1.) 

• If you have a video terminal, set auto XOFF/XON in SET-UP mode be- 
fore beginning the RT-11 installation procedure. Do so by executing the 
following instructions: 

1. Press the SET-UP key to put the terminal in SET-UP A mode. 

2. Press the 5 key on the main keyboard to put the terminal in SET-UP 
B mode. 

3. The terminal displays four groups of binary values. Look at the fourth 
entry in the second group of values. If that value is one, then AUTO 
XOFF/XON is correctly set: press the SET-UP key again to return 
the terminal to normal operation, and ignore steps 4, 5 and 6 below. If 
that value is zero, then AUTO XOFF/XON is not set: perform steps 4, 
5, and 6. 
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4. Press the right-arrow (-^) key, which is located at the upper right 
corner of the main keyboard, until the cursor is positioned over the 
fourth entry in the second group of displayed values. 

5. When the cursor is correctly positioned, press the 6 key on the main 
keyboard to change the value from zero to one. 

6. Save the current SET-UP features by typing [shft/s 1 . The terminal 
clears the screen, displays WAIT, and returns to SET-UP A mode. 

7. Press the SET-UP key again to return the terminal to normal 
operation. 

(See the VT125 User's Guide or the VT105 Graphic Terminal User's 
Manual for further information.) 

• Sometimes you must halt and bootstrap the processor. For example, you 
must do so to recover from a system failure or to bootstrap from a new 
disk on your system drive. Any time you must halt and bootstrap the 
processor, tj^e the commands in the following dialog: 

[ BREAK 1 (Press the BREAK key, which is located near the upper right 
corner of your keyboard. This halts the processor.) 

n n n n n ri 

i773000G (This bootstraps the processor from drive 0. Also, any time the 
terminal displays @ and the processor has halted, you can boot- 
strap the processor by typing this number.) 

RT-llxx U04.00 

(followed by any startup file commands) 

.DATE dd-mww-yy® 
.TIME hh itiuiisssdl) 

where n n n n n n is the address plus 2 at which the processor stopped 

K X is the name of the monitor in operation 

d d -mmiii- y •/ is the day, month, and year in the form lO-JAN-80 

h h ! (iiw ! s s is the current time in hours, minutes, and seconds 

NOTE 

If the preceding procedure does not bootstrap the processor, 
see the DECLAB-lllMNC User's Guide for additional 
information. 

• If you are unfamiliar with RT-11, read the Introduction to RT-11, but do 
not attempt to perform the exercises in that book. (You can perform the 
exercises after you have installed RT-11 and FORTRAN IV.) 

• Begin the RT-11 installation procedure. If you have two RL01/RL02 
disks, follow instructions in Section 2.2; if you have only RX02 diskette 
drives, follow instructions in Section 2.3. 
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NOTE 

Never type SET TT NOPAGE. Doing so could cause unpre- 
dictable results. 

2.2 Installing RT-11 with Two RL01/RL02 Disk Drives 

This section contains information on installing RT-11 on one or more 
RL01/RL02 disks. Section 2.2.1 presents procedures for using the FEP dis- 
tribution disk to create a development system disk. Section 2.2.2 discusses 
procedures for creating additional system disks. 

Sometimes these procedures instruct you to w^rite-protect or write-enable a 
disk drive. To write-protect a drive, press the drive's write-protect switch, 
and be sure the light in the switch is lit. To write-enable a disk, press the 
drive's write-protect switch, and be sure the light in the switch is not lit. 

2.2.1 Installing RT-11 by Using the FEP Distribution Disl( 

This section explains procedures for using the FEP distribution disk to: 

• copy itself 

• copy any other disk 

• install an SJ or FB monitor 

Note that Section 2.5.1 explains another use for the FEP distribution disk; 
that is, how to use that disk for installing the XM monitor. 

Throughout the dialogs listed in this section and in Section 2.5.1, note that: 

• The terminal displays an asterisk (*) before each line that contains a 
question. 

• The terminal displays a question mark (?) before each line that contains 
a completion message or error message. 

• The terminal displays a semicolon ( ! ) before each line that does not con- 
tain a question, completion message, or error message. 

• Brackets ( E ] ) enclose information about possible answers to a question. 
For example, if a question is followed by cy/N], you can answer \M) or 
NdH; if a question is followed by [S], your answer can be any string 
(consisting of one or more characters). 

• Whenever a line in the dialog instructs you to insert a disk into a drive, 
wait until the white light on the drive is lit before you insert the disk. 
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To install the SJ or FB monitor: 

1. Since you have powered on the MINC computer system according to the 
procedure listed in Section 2.1, the following dialog is displayed on your 
terminal. Copy the FEP distribution disk by typing the commands in 
this dialog: 

RT-ll/FEP U2.1 



Welcome to RT-ll/FEP uersion 2.1. 



The disK in DLO: is a d i s t ri but i om disK. 

The first thinsf you must do is to copy the files on that disk 
to an unused disK in DLl:. The follow insf procedure initializes 
an unused disK and copies the FEP distribution disk. 

Insert an unused disk in DLl: 
* Are you ready to continue? CY/N]: YdS) 

Initializing DLl: 

Checking DLl: for bad blocks 
? DUP-I-No bad blocks detected DLl: 

Copying files from DLO: to DLl: 

The disk in DLl: now contains a bootable kit 
which will help you to install FEP/RT. 

Remote the disk from DLO: and store it in a safe place. 
Refiioue the disk from DLl: and boot it in DLO: 

2. Make a copy of the RT-11 distribution disk by tj^ing the commands in 
the following dialog: 

RT-ll/FEP M2.1 



Welcome to RT-ll/FEP version 2.1. 

This disk provides automatic procedures for 
software installation. 

You must use t he RT- 1 1 /FEP and RT- 1 1 /FRP Installation and User 's 
Guide 

in conjunction with these procedures. 

Pleaseenter 

Today's date ( dd-mmm-y y ) : 

Enter a date in which dd represents the day (a decimal number 
from 1 to 31), m mm represents the first three characters of the name 
of the month, and v v represents the year (a decimal number from 

73 to 99): dd-mmm-yy® 
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Select the procedure youyant to perform bv t'/pifi3 one 
of the following codes: 

RT Build an RT-11 d eye I o pwen t system disK 
SYSGEN SysSen an XM won i to r 
COPY Copy <preserue) any disK 

Select a procedure CS3 : COPY Hi) 

This procedure copies a disk and beSins by 
initializing an output disk. 

Insert an unused disk inDLl: 

Are you ready to continue? [ Y / N ] : Y® 

Any data on DLl ! will be lost, Continue? CY/N] ! Y® 



InitializinSDLl: 

Cheokin3DLl:forbad blocks 
DUP-I-No bad blocks detected DLl: 

For the copy procedures 

The output uolufite is already in DLl : . 

The input uolume is the disk you want to copy. 

The systew uolunie is the FEP distribution disk. 

Mount output yoluwe in DLl: 5 Continue? YED 
Mount input volume in DLOs! Continue?Y® 
Mount system yolume in DLOs ! Continue? Y® 



Finished copyinS. 

* Do you want to copy bootstrap information? [Y/N]: 

If the disk in drive 1 is the copied RT-11 Distribution Disk or the 
RT-11 Autopatch disk, type Y® , otherwise, type n® . If you ts^pe 
YdH, the following question also appears. 

i 

* Enter filename of monitor CSl: 

If the disk in drive 1 is the copied RT-11 Distribution Disk, type 
RTi IBL.SYS®. If the disk in drive 1 is the RT-11 Autopatch disk, 

type AUTOP.SYS®. 

Bootst rap copied . 

Select the procedure you want to perform by typins the 
approp riate code. 

RT Build an RT-11 deuelopment system disk 
SYSGEN Syssen an XM monitor 
COPY Copy (preserue) any disk 



* Select a procedure CS] 



NOTE 



You can use the preceding COPY procedure to copy any 
disk (including the RT-11, FORTRAN IV, and FEP/FRP 
laboratory-software distribution disks as well as the 
RT-11 Autopatch Kit). 



2-8 Installing RT-11 



Use the following procedure to patch the copies of the RT-11 distribu- 
tion disk: 

• Bootstrap the copy of the RT-11 distribution diskette in drive 0. Re- 
move protection from files on the copied disk by typing the following 
command. (Use the NOLOG option to prevent a list of renamed files 
from appearing on the terminal.) 

.RENAME/SYSTEM/NOPROTECTIOIM/NOLOG DLO:*,# DLO:*.*® 

• Install the patches for RT-11 by following instructions for doing so in 
the RT-11 Autopatch User's Guide. 

• Bootstrap the copy of the RT-11 distribution disk, which you have 
now patched, in drive 0. Protect files on this disk by typing the follow- 
ing command: 

.RENAME/SYSTEH/PROTECTION/NOLOG DLO:*.* DLO:*,*(Ra) 

• The chapter titled Procedures Following an Autopatch Session in the 
RT-11 Autopatch User's Guide instructs you to make copies of the 
patched disk. Use the FEP distribution disk copy procedure, as de- 
scribed in step 2 of this section to make the copy. 

Use the following procedure to create a development system disk: 

• Bootstrap the FEP distribution disk in drive 0. 

• Type the commands in the following dialog: 

RT-ll/FEP M2.1 



Weloowe to RT-ll/FEP uersion 2.1. 

This disK proyides autamatio procedures for 
software installation. 

You must use the FEP/RT and RT-11/FRP Installation and User's 
Guide 5 in conjunction with these procedures. 

Please enter 

Today's date ( dd-mmm-y y ) : 

Enter a date in which d d represents the day (a decimal number 
from 1 to 31), mmw represents the first three characters of the 
name of the month, and y v represents the year (a decimal num- 
ber from 73 to 99): dd-Mmm-y'/dB 

Select the procedure you want to perform by typinS one 
of the follow in 3 codes: 

RT Build an RT-11 development system disk 
SYSGEN Syssen an KM monitor 
COPY Copy (preserve) any disK 

# Select a procedure [S]: RT® 

RT-11 INSTALLATION 
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This procedure creates an RT-11 system that includes 
the standard Monitor contained on the RT-11 
distribution Kit. You will need a blank disk that the 
procedure will initialize and onto which it will copy 
the RT-11 system. 

Insert an unused disk in DLl: 
« Are you ready to continue? [Y/Nl: Y® 

* Any data on DLl: will be lost. Continue? CY/ND: YdD 

Initializing DLls 

ChecKinSDLl: for bad blocks 
DUP-I-No bad blocks detected DLls 

For the next operation: 

The output Molunie is already in DLl : . 

The input yoluuie is the RT-11 distribution disk. 

The system uolurne is the FEP installation disk. 

Mount output uolurne in DLl:! Continue? Y® 
Mount input volume in DLO: ! Continue? YED 
Mount system uolurne in DLO: 5 Continue? Y® 
5 

* Do you haue a serial printer? CY/Nl: 

Type Y® or NdD. If you type YdB, the following question also 
appears. 

5 

« Which serial line unit is it connected to (Ot 1> or 2) ? 

Normally, the line printer is connected to serial line unit number 
2 (labelled SLU2) at the rear of the MINC chassis. However, the 
line-printer cable may instead be connected to SLUG or SLUl. 
Type oM>, iMi, or ZED. 

* Do you haue a parallel line printer? CY/N]: 

T5rpe YES or Ndi). 

5 

* Do you haue a uideo terminal? CY/Nl: 

Type YdD or NdD. 

Now deleting un needed files on DLl: 

Now squeezing DLl : 

Your disk now has an installed RT-11 deuelopment system 
which is equivalent to that recommended in Table 2-1 
in the RT-11/FEP and RT-11/FRP Installation and 
User's Guide. 

To proceed with the installation of FORTRAN IM » and 
the remaining FEP/RT components* remove the disK 
fromDLl: t boot it in DLO: t and follow the procedures in 
Chapter 3 and Chapter a of the RT-ll/FEP and RT-11/FRP 
Installation and User's Guide. 
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2.2.2 Using the RT-11 Installation and System Generation Guide 

This section contains information on creating one or more system disks that 
contain files not found in Table 2-1. Skip this section if you do not want to 
create such additional disks. 

To create specialized system disks, follow procedures in the RT-11 
Installation and System Generation Guide. Begin by reading the following 
chapters in that manual: 

Introduction 

Preparing for Installation 

Installing a System Distributed on Hard Disk to Run on a Hard Disk 

As you read those chapters, keep the following in mind: 

• Many commands in the instructions for installing RT-11 contain the ex- 
pressions XXn:, XXO:, and XXI:. For XX, type DL. For n, type o or l for 
disk drive or 1. (Such instructions include INITIALIZE, RENAME, 
SQUEEZE, and COPY.) 

• The RT-11 Installation and System Generation Guide presents several 
ways to initialize a hard disk. To initialize an RL01/RL02 disk, type: 

.INITIALIZE/BADBLDCKS DLn:® 

where n is o or i. 

Table 2-1: Recommended Contents of an RL01/RL02 Development 
System Disk 



File 


Comment 


RTllSJ.SYS 


If you want to use the SJ monitor. 


RTllFB.SYS 


If you want to use the FB monitor. 


DL.SYS ■ 




LP.SYS or LS.SYS 


If you have a line printer. 


NL.SYS 




TT.SYS 




BA.SYS 




SWAP.SYS 




CREF.SAV 




DIR.SAV 


- 


DUP.SAV 




KED.SAV 


If you have a video terminal. 


EDIT.SAV 


If you have a hard-copy terminal. 



(continued on next page) 
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Table 2-1: Recommended Contents of an RL01/RL02 Development 
System Disk (Cont,) 



File 


Comment 


FORMAT.SAV 




HELP.SAV 




LIBR.SAV 




LINK.SAV 




MACRO.SAV 




PATCH.SAV 




PAT.SAV 




PIP.SAV 




RESORC.SAV 




SIPP.SAV 




SLP.SAV 




SRCCOM.SAV 




SYSMAC.SML 




BATCH.SAV 




HELP.MLB 




HELP.EXE 




STARTF.COM 


If you have included RTllFB.SYS. 


STARTS.COM 


If you have included RTllSJ.SYS. 


ODT.OBJ 




PLOT55.0BJ 




TEST55.FOR 




SYSLIB.OBJ 




DEMOED.TXT 




DEM0X1.MAC 




DEMOBG.MAC 




DEMOFG.MAC 




DEMOFl.FOR 





The chapter entitled Installing a System Distributed on Hard Disk to 
Run on a Hard Disk in the RT-11 Installation and System Generation 
Guide contains discussions of the following procedures; read these discus- 
sions and perform the procedures described: 

1. Bootstrapping the distribution disk 

2. Preserving the distribution disk 
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3. Installing mandatory patches 

4. Creating the system from chosen components 

5. Installing the bootstrap on the disk 

2.3 Installing RT-11 with Two RX02 Disltette Drives 

This section contains information on creating RT-11 system diskettes. 
Section 2.3.1 presents procedures for using the FEP Installation Diskette to 
create a development system diskette. Section 2.3.2 discusses procedures 
for creating an additional system diskette, one which contains RT-11 
utilities. 

As you perform procedures described in this section, keep in mind the 
following: 

• Drive (also called DYO:) is the drive on the left. Drive 1 (DYl:) is the 
drive on the right. 

• The RT-11 distribution diskettes are labelled 1/4, 2/4, 3/4, and 4/4. The 
diskette labelled 1/4 is also known as diskette 1; the diskette labelled 2/4 
is diskette 2.. .the diskette labelled 4/4 is diskette 4. 

• You cannot write-protect an RX02 diskette. (However, individual files 
may have been protected by software. For information on protecting files 
by software, see the discussion of the RENAME command in the RT-11 
System User's Guide.) Therefore, be careful to avoid inadvertently de- 
stroying an important diskette during a FORMAT, INITIALIZE, COPY, 
or SQUEEZE operation. 

• During execution of a COPY command, your terminal may display a 
message such as the following, which indicates that you have used all 
available space on a diskette: 

?PIP-F-DeMice full DYl : f i Inarn . ex t 

where f i i n anu e x t is the name of the first file not copied to the output 
device (normally DYl: is the output device). 

If this happens, create free space on your diskette by performing the 
following procedures. 

1. Delete unnecessary files from the diskette by tj^jing: 

.DELETE DYl ! aaaaaa. ttt tDYl : bbbbbb . ttt ( . , ,DY1 ; zzzzzz , tttElI) 
DYl : aaaaaa. ttt ? YE) 
DYlsbbbbbb.ttt ? Y(aS) 
DYl:zzzHzz.ttt ? Y® 

where aaaaaa. ttt through zzzzzz.ttt are the names of a maxi- 
mum of six files to be deleted. 
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NOTE 

If you are deleting a system (.SYS) file, use the /SYSTEM 
option with the DELETE command. If a file you want to 
delete is protected, use the RENAME command to remove 
protection before you delete the file. (For further informa- 
tion on the DELETE and RENAME commands see the 
RT-11 System User's Guide.) 

2. Collect free space on the diskette into one contiguous area by typing: 

.SQUEEZE DYl -.m 

D Y 1 : / Sq Li e e z e j Are you sure? Y® 

3. After the terminal displays the system dot, again type the COPY 
command that failed. 

2.3.1 Installing RT-11 by Using the FEP Installation Diskette 

This section explains procedures for using the FEP Installation Diskette to: 

• copy itself 

• copy any other diskette 

• install an SJ or FB monitor 

Note that Section 2.5.2 explains another use for the FEP Installation 
Diskette; that is, how to use that diskette for installing the XM monitor. 

Throughout the dialogs listed in this section and in Section 2.5.2, note that: 

• The terminal displays an asterisk (*) before each line that contains a 
question. 

• The terminal displays a question mark (?) before each line that contains 
a completion message or error message. 

• The terminal displays a semicolon ( 5 ) before each line that does not con- 
tain a question, completion message, or error message. 

• Brackets ( [ ] ) enclose information about possible answers to a question. 
For example, if a question is followed by cv/N], you can answer Y® or 
hW). If a question is followed by CS], your answer can be any string 
(consisting of one or more characters). 

To install the SJ or FB monitor: 

1. Since you have powered on the MINC computer system according to the 
procedure listed in Section 2.1, the following dialog is displayed on your 
terminal. Copy the FEP Installation Diskette by typing the commands 
in this dialog: 
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RT-11/FEP M2. 1 



Welcome to RT-11/FEP uersion 2.1. 



The diskette in DYO: is a distribution diskette. 
The first thinS vou must do is to copv the files 
on that diskette to an unused diskette in DYl:. The 
follouiinsf procedure forwats and initializes an 
unused diskette and copies the distribution 
diskette. 

Insert an unused diskette in DYl: 
# Are vou ready to continue? CY/N]: Y® 
5 

; Fo rmat t in 3 DYl : 
? FORMAT- I-Fo rdiat t in 3 complete 

! In it ial izinS DYl : 

? DUP-I-No bad blocks detected DYl s 

i 

; Copy ins f i Iss f row DYO: to DYl : 

9 

5 The diskette in DYl: now contains a bootable 

5 installation diskette which will help you to 

5 install FEP/RT, 

5 

; Remoue the diskette from DYO: and store it in 

; asafeplace. 

? , . 

; Remoue the diskette f rom DYl : and boot it in DYO : . 



2. Make copies of the four RT-11 distribution diskettes by typing the com- 
mands in the following dialog: 

RT-ll/FEP V2. 1 



5 Welcome to RT-ll/FEP Mersion 2.1. 

5 

i This installation diskette prow ides automatic 

i procedures for software installation. 

? 

! You must use the RT-ll/FEP and RT-11/FRP Installation and 

) User's Guide in conjunction with these procedures. 



Please enter 

Today's date d d - m m m - y y : 

Enter a date in which dd represents the day (a decimal number 
from 1 to 31); mmm represents the first three characters of the name 
of the month; and y y represents the year (a decimal number from 
73 to 99): dd-mmm-yyiSiT) 

Select the p r o c e d u r e y o u want to perform by t y p i n 3 one 
of the follow in3 codes: 

RT Build an example RT-11 deyelopment system diskette 

SYSGEN SysSen an XM monitor 
; COPY Copy ( p r e s e r M e ) any diskette 
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I 

* Select a procedure CS3! COPYdB 
i 

; This procedure copies a diskette and besins by 
i foriiiattinS and initializing an output diskette. 

i 

i Insert an unused diskette in DYls 

* Are you ready to continue? C Y / N ] s YiD 
! 

* Any data on DYl s will be lost . Continue? CY/N] s Yd!) 

i Fo ririat t in S DYl ! 

? FORMAT- I-Fo rmattinS ooMPl ete 

i Init i al i zinS DYl ! 

? DUP-I-No bad blocks detected DYl: 

i 

i Forthe copy procedurei 

i 

i The output uoluhie is already in driye 1. 

i The input volume is the diskette you want to copy. 

1 The system yoluwe is the FEP installation diskette. 

Mount output yoluwe in DYl : ! Continue? YdB 
Mount input vol urn e in DYOs i Continue? Y® 
Mount system uo 1 uine in DYO : ! Continue? YdID 

Finished copying 

* Do you want to copy the bootstrap? CY/N]: 

If the diskette in drive 1 is copied RT-11 distribution diskette 
number 1 or RT-11 Autopatch diskette number 1, type "&; other- 
wise, type N®. If you type YdS, the following question also appears. 

i 

* Enter filename of monitor CS]: 

If the diskette in drive 1 is copied RT-11 distribution diskette 
number 1, type RTi iBL.SYSdi). If the diskette in drive 1 is RT-H 
Autopatch diskette number 1, type AUTOP.SYSdB. 

! 

! Bootstrap copied. 
! 

* Do you want to copy another diskette? [Y/N]: YlM) 



Repeat the COPY procedure until you have copied all four RT-11 distri- 
bution diskettes. Store the RT-11 distribution and FEP Installation 
diskettes in a safe place. Use only the copies for developing and execut- 
ing programs. 

NOTE 

You can use the COPY procedure found on the FEP 
Installation Diskette to copy any diskette (including 
RT-11, FORTRAN IV, and FEP distribution diskettes as 
well as the RT-11 Autopatch Kit). 
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3. Patch the copies of the RT-11 distribution diskettes by using the follow- 
ing procedure, which may require as much as one-and-one-half hours to 
perform: 

• Bootstrap the copy of RT-11 Distribution Diskette 1 in drive 0. Re- 
move protection from files on this diskette by typing the following 
command. (Use the NOLOG option to prevent a list of renamed files 
from appearing on the terminal.) 

.RENAME /SYSTEM /NO PROTECT I ON /NOLOG DYO:'*.* DYO:*.*® 

• Mount a copy of one of the remaining RT-11 distribution diskettes in 
drive 1. Remove protection from files on the copied diskette by typing 
the following command. (Use the NOLOG option to prevent a list of 
renamed files from appearing on the terminal.) 

.RENAME/SYSTEM/NOPROTECTION/NOLDG DYl:*,* DYl:*.*® 

Remove protection from each of the copied RT-11 distribution 
diskettes. 

• Install the patches for RT-11 by following instructions for doing so in 
the RT-11 Autopatch User's Guide. 

• Bootstrap the copy of RT-11 Distribution Diskette 1, which you have 
now patched, in drive 0. Protect files on this diskette by typing the 
following command: 

.RENAME/SYSTEM/PROTECTION/NOLOG DYO:*,* DYO:*.#(ll) 

• Mount a patched copy of another RT-11 distribution diskette in drive 
1. Protect files on the patched diskette by typing the following com- 
mand. (The NOLOG option prevents a list of renamed files from ap- 
pearing on the terminal.) 

, RENAME/SYSTEM/PROTECTION/NOLOG DYl:*.* DYl:*.*® 

Protect files on each of the patched diskettes. 

• The chapter titled Procedures Following an Autopatch Session in the 
RT-11 Autopatch User's Guide instructs you to make copies of the 
patched diskettes. Use the FEP Installation Diskette copy procedure, 
as described in step 2 of this section, to make the copies. 

4. Use the following procedure to create a development system diskette: 

• Bootstrap the FEP Installation Diskette in drive 0. 

• Type the commands in the following dialog: 

RT-ll/FEP M2.1 



Welcome to RT-ll/FEP version 2.1. 

This installation diskette pro u ides automatic 
procedures for software installation. 
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You must use the RT-11/FEP and RT-11/FRP Installation and 
User's Guide in conjunction with these procedures. 



Please enter 

Today's date (dd-ftiiTiiti-'/y)! 

Enter a date in which d d represents the day (a decimal number 
from 1 to 31), mmm represents the first three characters of the 
name of the month, and v y represents the year (a decimal num- 
ber from 73 to 99): dd-mmm-yy® 

5 

I Select the procedure you want to perform by t y p i n 3 one 

; of the following codes: 

5 

5 RT Bui Id an RT-1 1 deuelopfiient system diskette 

I SYBGEN Syssen an XH monito r 

! COPY Copy (preserve) any disKette 

5 

* Select aproce du re CSIjRTB) 

; RT-11 INSTALLATION 

) 

; This procedure creates an RT-11 system that 

; includes a standard monitor contained on the RT-l 1 

; distribution Kit, You will need a blanK diskette that the 

; procedure will format and initialise and onto which it 

1 will copy the RT-11 system. 

5 

; Insert an unused disKette in DYl: 

* Are you ready to continue? [Y/Nl: YdS 
5 

» Any data on DYl: will be lost. Continue? CY/Nl: Y® 

i 

; Formattins DYl : 

? FORMAT-I-Fo rmattinS complete 

5 

; Initializing DYl: 

? DUP-I-No bad blocKs detected DYl: 

! 

i For the next operation* 

; The output volume is already in DYl:. 

; The input volume is disKette 1 of the RT-11 distribution kit. 

; The system volume is the FEP installation diskette. 

i 

Mount output volume in DYl: i Continue? YdB 

Mount input volume in DYO; i Continue? YdB 

Mount system volume in DYO: i Continue? YdD 

5 

; You can instaUeither the RT-11 SJ or the RT-11 FB monitor 

* Do you want the RT-ll FB monitor? EY/Nl: 

Type Y® or n®. 

1 

* Do you have a serial printer ? [Y/Nl: 

Type Y® or NdD. If you type YdD, the following question also 
appears. 
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« Which serial lineunit is it connected to (0> 1» orZ) ? 

Normally, the line printer is connected to serial line unit number 
2 (labelled SLU2) at the rear of the MINC chassis. However, the 
line-printer cable may instead be connected to SLUG or SLUl. 
Type OM), iM), or zM), 

* Do you have aPfirallelline printer? [Y/N]: 

Type Y® or N®. 

5 

* Do you haue a uideo te rminal [Y/N]: 

Type YdB or N®. 

Wo rK in 3 . . . 
Wo rk in 3 * > > 
W r K i n 3 * t ♦ 
W r K i n 3 . t ♦ 

For the next operation* 

The input yolume is diskette 2 of the RT-11 distribution Kiti 

The output u 1 u m e is already in D Y 1 . 

The system yoluwe is the FEP installation disKette* 

Mount input uolume in DYOsI Cont in ue? YiH) 
Mount output yoluriie in DYl:! Continue? YdB 
Mount s y s t e ft) u o 1 u m e in D Y s i C o n t i n u e ? Y® 

Now squeezing DYl : 

Your diskette now has an installed RT-11 deuelopwent system 
which is equiualent to that reoowmended in Table 2-2 
in the FEP/RT Installation and User's Guide, 

To proceed with the installation of FORTRAN IMt and 
the r e m a i n i n 3 FEP components) r e m o u e the diskette 
from DYl ! > boot it in DYOs t and follow the procedures 
in Chapter 3 and Chapter 4 of the RT-11/FEP and RT-11/FRP 
Installation and User's Guide. 
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Table 2-2: Contents of the RX02 Development System Diskette 



File 


Comment 


RTllSJ.SYS 


If you have installed the SJ monitor. 




RTllFB.SYS 


If you have installed the FB monitor. 




DY.SYS 






LP.SYS or LS.SYS 


If you have a line printer. 




TT.SYS 






SWAP.SYS 






CREF.SAV 






DIR.SAV 






DUP.SAV 






KED.SAV or EDIT.SAV 


Both are text editors. EDIT is on the disk if you 
a hardcopy terminal. KED is on the disk if you 
a video terminal. 


have 
have 


FORMAT.SAV 






HELP.SAV 






LIBR.SAV 






LINK.SAV 






MACRO.SAV 






PIP.SAV 






RESORC.SAV 






SYSMAC.SML 






STARTS.COM 


If you have installed RTllSJ.SYS. 




STARTF.COM 


If you have installed RTllFB.SYS. 




SYSLIB.OBJ 






DEMOED.TXT 






DEMOXl.MAC 






DEMOBG.MAC 






DEMOFG.MAC 






DEMOFl.FOR 
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2.3.2 Building an RX02 Utilities Diskette 

In an ideal installation, one disk is large enough to contain an entire work- 
ing system. However, RX02 diskettes are not large enough to do this. 
Therefore, even though you have now created a development system disk- 
ette, you may also want to create an additional system diskette, one that 
contains infrequently used utilities. To begin creating a utilities diskette, 
read the following chapters of the RT-11 Installation and System 
Generation Guide: 

Introduction 

Preparing for Installation 

Installing a System Distributed on RX02 to Run on RX02 (if you have only 
RX02 diskette drives) 

As you build the utilities diskette, keep in mind the following: 



• 



Many commands in the instructions for installing RT-11 contain the ex- 
pression XXn:, XXO:, and XXI:. For XX, type DY. For n, type or 1 for 
diskette drive or 1. (Such instructions include FORMAT, INITIALIZE, 
SQUEEZE, COPY, and RENAME.) 

When you build your utilities diskette, copy to an RX02-formatted, ini- 
tialized diskette at least the files found in Table 2-3. (Those and other 
files are listed and defined in the table of RT-11 Software Components in 
the RT-11 Installation and System Generation Guide.) 

The chapter entitled Installing a System Distributed on RX02 to Run on 
RX02 in the RT-11 Installation and System Generations Guide contains 
discussions of the following procedures; read these discussions and per- 
form the procedures described: 

1. Bootstrapping the distribution disk 

2. Creating the system from chosen components 

3. Installing the bootstrap on the disk 
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Table 2-3: Recommended Contents of an RX02 Utilities Diskette 



File 



RTllSJ.SYS 

RTllFB.SYS 

DY.SYS 

LP.SYS 

LS.SYS 

TT.SYS 

SWAP.SYS 

CREF.SAV 

DIR.SAV 

DUF.SAV 

KED.SAV or EDIT.SAV 

FORMAT.SAV 

HELP.SAV 

LIBR.SAV 

LINK.SAV 

MACRO.SAV 

PATCH.SAV 

PAT.SAV 

PIP.SAV 

RESORC.SAV 

SIPP.SAV 

SLP.SAV 

SRCCOM.SAV 

SYSMACSML 

BINCOM.SAV 

DUMP.SAV 

STARTS.COM 

STARTF.COM 

SYSLIB.OBJ 



Comment 



If you want to use the SJ monitor. 
If you want to use the FB monitor. 

If you have a parallel line printer, such as an LA180. 
If you have a serial line printer, such as an LA120. 



Both are text editors. Include EDIT if you have a 
hardcopy terminal. Include KED if you have a video 
terminal. 



If you have included RTllSJ.SYS. 
If you have included RTllFB.SYS. 
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2.4 Customizing the System 

The RT-11 Installation and System Generation Guide lists many optional 
procedures for customizing the system without performing the system gen- 
eration procedure. A common procedure of this type is the addition of com- 
mands to the startup indirect command files. 

An RT-1 1 monitor looks for a startup indirect command file whenever you 
bootstrap the system. Each monitor looks for a particular file. The single- 
job monitor looks for STARTS.COM; the foreground/background monitor 
looks for STARTF.COM; the extended-memory monitor looks for 
STARTX.COM. If the monitor finds a startup command file, it executes the 
commands in that file. If you want to add commands to a startup command 
file, add them to the file that your monitor uses. (For information on indi- 
rect command files, see the RT-11 System User's Guide.) 

If you have no listing device and want the terminal to be the default listing 
device, add the following command to the startup indirect command file: 

ASSIGN TT LP 

The RT-11 Installation and System Generation Guide contains discussions 
of the following procedures: 

1. Customizing the system (optional) 

2. Compressing the disk 

3. Preserving the working system 

4. Testing the working system 

If you have RL01/RL02 disks and want to customize your system, read 
those discussions in the chapter entitled Installing a System Distributed on 
Hard Disk to Run on a Hard Disk. If you have RX02 diskettes, read the 
discussions in the chapter entitled Installing a System Distributed on RX02 
to Run on RX02. Perform the procedures described. 

2.5 Performing the System-generation Process 

Before you execute the system-generation process, note the following: 

' You should now have created a system disk by using the RT option on the 
FEP Installation Diskette. If you have not, do so now by following the 
procedures listed in Section 2.2 (if you have two RL01/RL02 disk drives) 
or Section 2.3 (if you have only RX02 diskette drives). You must have 
created a system disk before you perform a SYSGEN. 

For a list of the features in the monitor you have installed (SJ or FB), 
consult the table titled Features Available in Distributed Monitor in the 
RT-11 Installation and System Generation Guide. Perform the system- 
generation process only if you need additional features not included in 
the standard monitors. 
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• 



• 



• 



• 



To install the XM monitor, use the SYSGEN option on the FEP 
Installation Disk. (See Appendix B for a list of the answers that the 
SYSGEN option uses in executing the system generation procedure.) To 
use the SYSGEN option, follow the instructions in Section 2.5.1 (if you 
have RL01/RL02 disks) or in Section 2.5.2 (if you have RX02 diskettes). 

Users of the IBS software may need to perform a SYSGEN for the follow- 
ing reasons: 

Distributed RT-11 monitors contain 16 device slots. If your hardware 
system has fewer than 16 different types of devices (other than 
MNC-series modules) connected to it when it is booted, the IB handler 
will be installed automatically as long as the IBVll-A unit itself is con- 
nected to the hardware system. If all of the device slots are occupied, you 
can remove a device handler from the system to make a device slot avail- 
able for the IB handler. If you cannot remove any device handlers and if 
you have no extra device slots, you will have to regenerate your RT-11 
monitor. See Section 2.8.13 of the RT-11 Installation and System 
Generation Guide for more information. 

NOTE 

Most MINC-family systems use fewer than eight device 
slots. 

For a list of other modifications available only through SYSGEN, consult 
the table of Features Available Only through System Generation Process 
in the introductory chapter of the RT-11 Installation and System 
Generation Guide. 

If you decide to perform a SYSGEN for any reason other than to install 
the XM monitor, follow the instructions in the RT-11 Installation and 
System Generation Guide, and see Section 2.5.3 of this manual. 

• If you decide not to perform a SYSGEN, skip the remainder of this 
chapter and proceed to Chapter 3. 

2.5.1 Using the SYSGEN Option with Two RL01/RL02 Disl<s 

To use the FEP distribution disk to perform a SYSGEN that creates an XM 
monitor, perform the following procedures: 

1. Bootstrap the FEP distribution disk in drive 0. 

2. Type the commands in the following dialog (for a list of documentation 
conventions observed in this dialog, see Section 2.2.1): 

RT-U/FEP V2.1 



Welcome to RT-11/FEP uersion 2.1. 

This disk prouides automatic procedures for 
software installation. 



• 
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; You must use the RT-U/FEP and RT-11/FRP Installation and 
; User's Guide in con Junct ion with these procedures . 

Please enter 

Today's date ( dd-wmin- yy ) : 

Enter a date in which dd represents the day (a decimal number 
from 1 to 31), itiMw represents the first three characters of the name 
of the month, and y y represents the year (a decimal number from 

73 to 99) :dd-ritfTHri-yy(aa) 
! 

5 Select the procedure you want to perform by typinS one 
I of the following procedures; 
3 

; RT Bui Id an RT- 1 1 deMelopment system disk 

5 S Y S G E N S y s 3 e n a n X H m n i t r 

5 COPY Copy (preserve) any disK 

5 

* Select a procedure CS]i SYSGENdD 
3 

; RT-ll XH SYSGEN 

5 

! This procedure creates an XM tiioni to r t which can be used 

? only with an 11/23 processor. 

! 

; Before d o i n s the s y s s e n > you should h a w e installed an 

5 RT-ll Monitor (for example* by usinS the RT procedure on 

i this disK) and should also have become familiar with RT-ll, 

; Continue with the s y s S e n only if you h a u e already done both. 

* Do you want to continue with the SYSGEN? [Y/Nli 

Type YdB or N®. 

; Insert the RT-ll distribution disK in DLl: 
? 

* Ready? CY/Nl: Y® 
? 

i ASSEMBLING AND LINKING SYSTEM FILES 

! 

i THIS PROCESS WILL RUN UNATTENDED FOR ABOUT 20 MINUTES 

5 

; Remoye the RT-ll Distribution DisK from DLl: 

3 

* Continue? CY/N]! Y® 
5 

! This procedure will copy the system files » which resulted 

; from the sysSen procedure* to a tarSet system <an RT-ll system 

? disK of your choice). If you used the FEP distribution 

) disK to create an RT-1 1 d e ue 1 o pmen t system » you can use 

; the disk that resulted from that procedure as a tarSet 

! system. 

5 

i NOTE! The tarSet system must have at least 110 blocks 

; of f ree space . 

? 

* Do you want to copy the new system files at this time? CY/N]: YE) 
5 

! Insert the disk that contains the tarset system in DLl: 
5 

* Ready? EY/N]: Y® 
! 
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Your RT-1 1 XM sysSen is complete . The current system 
disKj which is a copy of the FEP distribution diskt 
contains object and map files that you will find 
useful in the future. It also contains the system 
files resulting from the syssen process. You can copy 
these files to a system disk of your own at any time . 
The system files created by the sysSen have the ,SYG file 
type. 

i <EOF> 



2.5.2 Using the SYSGEN Option with Only RX02 Dislcettes 

To use the FEP Installation Diskette to perform a SYSGEN that creates an 
XM monitor, perform the following procedures: 

1. Bootstrap the FEP Installation Diskette in drive 0. 

2. Type the commands in the following dialog (for a list of documentation 
conventions observed in this dialog, see Section 2.3.1): 

RT-ll/FEP UZ. 1 



Welcome to RT-ll/FEP version 2.1. 

This installation diskette provides 

automatic procedures for software installation. 

You must use the RT-ll/FEP and RT-11/FRP Installation and 
User's Guide in conjunction with these procedures. 

Please enter 

Today's date ( d d - m m m - y y ) : 

Enter a date in which dd represents the day (a decimal number 
from 1 to 31), mmm represents the first three characters of the name 
of the month, and y y represents the year (a decimal number from 

73 to 99): d d - mmm - y y® 



Select the procedure you want to perform by typins one 
of the following codes. 

RT Build an RT-1 1 development system diskette 

SYSGEN Sys3en an XM monitor 

COPY Copy (preserve) any diskette 

♦ Select a procedure [S]: SYSGENiS) 

RT-ll XM SYSGEN 

This procedure creates an XM monitort which can 
be used only with an 11/23 processor. 

Before doinS the sysSent you should have installed an 
RT-ll monitor (for example* by usinS the RT procedure on 
this diskette) and should also have become familiar with 
RT-ll. Continue with the syssen only if you have already 
done both ♦ 
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* Do you yant to continue with the SYSGEN? CY/N3 : 

Type Yd!) or nm. 

For this procedure » '/ouwill need one blank diskette. 
This diskette) which is referred to as the work 
voluwet will receive the object modules and link map 
which result from the RT-11 system feneration. You 
should retain the work uolume for future reference. 

Insert the diskette to be used as the work yolume in DYls 

* Ready? [Y/N] ! Y® 

* Any data on DYl s will be lost . Continue? C Y/N] : YEID 

Fo rmattins DYl : 

FORMAT- I-Fo rmatt in S complete 

Initializing DYl : 

DUP-I-No bad blocks detected DYl: 

For the next operation: 

The input yolume is diskette 1 of the RT-11 distribution Kit. 
The output volume is the work volume (already in DYls), 
The system volume is the FEP installation diskette. 

Mount input volume in DYO: 5 Continue? Y® 
Mount output volume in DYl:; Continue? YiS) 
Mount system volume in DYO; 5 Continue? YdH 

Insert diskette 3 of the RT-11 distribution kit in DYl: 

* Ready? [Y/Nl; Y® 

For the next operation: 

The input volume i s the wo rk vol ume . 

The system volume is the FEP installation diskette. 

(The system vol ume will be requested only if an error occurs ) 

; 

Mount input yolume in DYO: i Continue? Yd!) 

RT-U/FEP U2,i 

5 

? ASSEMBLING AND LINKING SYSTEM FILES 

9 

5 THIS PROCESS WILL RUN UNATTENDED FOR ABOUT 30 MINUTES 

5 

; Remove the RT-11 distribution diskette fromDYl: 

i 

* Continue? CY/ND: Yd!) 

; This procedure will copy the system files* which resulted 

I from the sysSen proceduret to a tarSet system (an RT-11 system 

5 diskette of your choice). If you used the FEP installation 

5 diskette to create an RT-11 development system* you can use 

; the diskette which resulted from that procedure as a target 

; system. 

? 

i NOTE: The tarSet system must have at least 110 blocks 

I of free space. 
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* Do you want to copy the new system files at this time? CY/N]:Y(Bi3 
Insert the disKette that contains the tar3et system in DYls 

* Ready? CY/N]: Y® 

Your RT- 1 1 XM sy s Sen is complete. Save the sy s Sen wo rK 
disKette (the current system disKette) for future 
reference. It contains object and map files which you 
will find useful in the future. It also contains the 
system files resultinS from the svsSen process. You 
can copy these files to a system disKette of your own 
at any time. The system files created by the sysSen have 
the .SYG file type . 



2.5.3 Performing a SYSGEN Using tiie RT-1 1 Installation and 
System Generation Guide 

If you perform a SYSGEN by following instructions in the RT-11 
Installation and System Generation Guide, keep the following in mind: 

• If you have EX02 diskette drives and perform a SYSGEN, be sure to 
enable support of diskettes in both RXOl and RX02 format. (You need 
RXOl support to access software that has been distributed in RXOl 
format.) 

• If you perform a SYSGEN, answer Y to the question that asks whether 
you want all the keyboard monitor commands. Many of the installation 
procedures in this manual require you to use those commands, such as 
SQUEEZE, RENAME, and LINK. 

• The RT-11 Installation and System Generation Guide contains an appen- 
dix that lists answers to SYSGEN questions. One section of this appendix 
lists answers that duplicate the standard single-job and 
foreground/background monitors. When you perform a SYSGEN, use 
these answers to enable standard features; supply your own answers to 
enable nonstandard features. For example, to create a monitor that is 
identical to a standard monitor except that it also includes multi-termi- 
nal support, use those answers but answer Y to the question that asks if 
you want multi-terminal support. (Note that answering Y to that ques- 
tion causes SYSGEN to ask two additional questions.) 

• If you choose multi-terminal support, do not assign an SLU for use by a 
terminal if you plan to use that SLU for REAL-11/MNC serial I/O (see 
Section A.3.12). 

• Read the sections in the RT-11 Installation and System Generation 
Manual on performing the system generation process if you plan to per- 
form that process. 
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Chapter 3 

Installing FORTRAN IV 



The FORTRAN IV distribution media contain a standard compiler and 
OTS (Object-Time System) as well as programs for building the FORTRAN 
IV software and tailoring it to meet your needs. 

DIGITAL strongly recommends that you build the software rather than use 
the standard FORTRAN IV. One reason for doing so is that only by build- 
ing the software yourself can you enable FORTRAN IV programs to use the 
floating-point hardware. In addition, instructions for installing some 
FORTRAN IV patches may require your performing the FORTRAN IV 
build procedures. 

If you decide to build FORTRAN IV yourself, use the installation and build 
procedures given in this chapter. If you decide to install the standard 
FORTRAN IV software, follow instructions given in the RT-11 FORTRAN 
IV Installation Guide and ignore the remainder of this chapter. 

Sections 3.1 and 3.2 contain instructions for building FORTRAN IV. (See 
Figure 3-1 for an overview of the installation process.) If you have two 
RLOl or RL02 disks, perform the procedures described in Section 3.1. If you 
have only RX02 diskettes, perform the procedures described in Section 3.2. 

3.1 Installing FORTRAN IV When Using Two RL01/RL02 Disk 
Drives 

Read this section before you begin the FORTRAN IV installation proce- 
dures. This section contains information that will help you install and build 
FORTRAN IV. For further information, consult the RT-11 FORTRAN IV 
Installation Guide. 
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The FORTRAN IV installation procedure involves the following operations: 

1. Preparing for installation 

2. Preserving the distribution disk 

3. Patching the copied disk 

4. Building the compiler and OTS (Object Time System) on your develop- 
ment system 

5. Testing the installed compiler and OTS 

6. Preserving the development system disk 

Figure 3-1: Building FORTRAN IV 
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3.1 .1 Preparing to Install FORTRAN fV 

Before beginning the FORTRAN IV installation procedure: 

• Gather the following; 

RT-11 FORTRAN IV Installation Guide 

The RT-11 Autopatch Kit 

FORTRAN IV distribution disk 

One blank disk 

The disk onto which you have backed up your development system 

• Read the FORTRAN IV Installation Guide 

• See Table 3-1 to verify that you have the minimal software needed for 
installing FORTRAN IV. 

Table 3-1: Minimal Software Needed for Installing FORTRAN IV 



FUe 



RTllSJ.SYS 

RTllFB.SYS 

DL.SYS 

DY.SYS 

LP.SYS 

LS.SYS 

TT.SYS 

SWAP.SYS 

CREF.SAV 

DIR.SAV 

DUP.SAV 

FORMAT.SAV 

LIBR.SAV 

LINK.SAV 

MACRO.SAV 

PIP.SAV 

RESORC.SAV 

SYSMAC.SML 

STARTS.COM 

STARTF.COM 

SYSLIB.OBJ 



Comment 



If you want to use the SJ monitor. 

If you want to use the FB monitor. 

If you have two RL01/RL02 disk drives. 

If you have only RX02 diskette drives. 

If you have a parallel line printer, such as an LA180. 

If you have a serial line printer, such as an LA120. 



If you have included RTllSJ.SYS. 
If you have included RTllFB.SYS. 
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3.1 .2 Preserving the Distribution Disk 

Preserve the FORTRAN IV distribution disk by executing the following 
instructions. (Use this procedure to preserve any disk that does not contain 
the operating system.) 

1. Write-protect drive 0. 

Bootstrap your development system disk in drive 0. 

Mount a blank disk in drive 1. 

Initialize the disk in drive 1 by typing the following commands: 

. INITIALI2E/BADBL0CKB DLl:(ll) 
DLl:/INITIALIZEi Are you sure? Yd!) 
?DUP-I-No bad blooKs detected DLl: 

NOTE 

If the system finds bad blocks, see the discussion of the 
INITIALIZE command in the RT-11 System User's 
Guide for additional information. 

2. Copy the disk by typing: 

,SQUEEZE/0UTPUT:DL1:/NAIT DLO;® 
Mount output yolume in DLl: i Continue?Y® 
Mount input yolume in DLO: i Continue? 

Remove the development system disk from drive 0. 
Mount the disk to be copied in drive 0. 
When the READY light is lit, type vdH. 

3. When copying is complete, the terminal displays: 

Mount system y o 1 u m e in DLO: i Continue? 

Remove the disk from drive and store it in a safe place. 

Mount the development system disk in drive 0. When the READY light 

is lit, type YdB. 

3.1 .3 Patching the Copied Disk 

1. Be sure that the development system disk is bootstrapped in drive 
and the copied FORTRAN distribution disk is mounted in drive 1. 

2. Remove protection from files on the copied disk by tjrping the following 
command. (Use the NOLOG option to prevent a list of renamed files 
from appearing on the terminal.) 

.RENAME/SYSTEM/NOPROTECTION/NOLOG DLl:*.* DLl:*,*® 

3. Apply the patches for FORTRAN IV by following instructions in the 
RT-11 Autopatch User's Guide. 
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4. Bootstrap the development system disk in drive 0, and mount the 
patched disk in drive 1. Protect files on the patched disk by typing the 
following command. (The NOLOG option prevents a list of renamed 
files from appearing on the terminal.) 

.RENAME/BYSTEM/PROTECTION/NDLOG DLl;*,* DLl:*.*® 

3.1.4 Building the Compiler and OTS 

Use the following sample dialog as a guide to answering questions asked by 
the system as it builds the compiler and OTS. Before executing the dialog, 
be sure that your development system disk is on drive and that your copy 
of the FORTRAN IV distribution disk is on drive 1. Write-enable drive 0, 
and write-pro tect drive 1. 

(This dialog contains answers likely to be useful to you. For alternative 
answers, consult the RT-11 FORTRAN IV Installation Guide.) 



.ASSIGN DLO: OUPdB 

.ASSIGN DLl : INPdH 

.RUN INPsFORGENdU 

Answer questions with: 

"?" or carriase return (<CR>) for info rmat ion » 

YES(Y) for affirmation t anything else for NO. 



A maxiwufi) of 56 lines are allowed per listinS pa3e. 

Is this acceptable? YES) 

A maximum of 136 characters are allowed in a formatted 

(ASCII) record, Is this acceptable? YiD 

A maximum of 6 channels mav be open at a Siuen time. 

Is this acceptable? YdB 

The FORTRAN compiler can compile svstem-spec if i c OPEN and CLOSE 

statement keywords for RT-llt RSX-11» and RSTS/E systems. These 

statements are currently compiled for the following systems RT-11 

Is this acceptable? Y(E) 

Based on your system's hardware configuration the default 

type of code 3enerated by the FORTRAN compiler will be xxx. 

Is this acceptable? YdlD 

(where xxx is FIS if you have an 11/03 processor or EIS if you 
have an 11/23 processor). 

Do you wish an inline only c ompi 1 e r? N® 

(You need a threaded compiler to use FDT.) 

Compiler options selection complete. 

Types iOUPsFORBLD to initiate the actual buildinS 
ofthecompiler, 

.SOUPiFORBLDdS 

SINPsFaLINK 
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,R LINK 

#OUP:FORTRA=INP:FRODT///S 
*INP!FO »OUP:DEFLTS/Ol!l 
*INP:Fl/0: 1 
«INP:F2/0:1 
*INP:F3/0:1 
*INP:Fa/0! 1 
*INP:F5/0:1 
*INP;FB/0: 1 
*INP:F7/0: 1 
*INP!F8/0! 1 
#INP!F9/0! 1 
*INP:F10/0!l 
♦INPuLOOP/On 1 
*I1\IP:F11/0:1 
*INP:F12/0: 1 
*INP:C0NMRT/0:1 
#INP:REGALO/0!l 
*INP!F14/0! 1 
*INP:F20/0:1 
*INP:F19/0:1 
*INP:F21/0: 1 
*INP:PEEP/0! 1 
*INP:0BJGSD/0:1 
•INPsFlB/Os 1 
*INP:F13/0! 1 
»INP!F15/0: 1 
,*INP!FlB/0! 1 
#INP!F17/0: 1 
*INP:CDUMP/Oii 1// 
*'-C 

.RUN INPnOTSGENEEl 

Answer questions with: 

"?" or carriage return C<CR>) for information t 

YES(Y) for affirmationf anvthins else for NO. 



The following questions refer to the b u i 1 d i n S of the 
default FORTRAN library. 

The FORTRAN library ootuponents are normally added to 

the default RT-11 system library file. SYSLIB.OBJ. 

Is this acceptable? Y® 

The default FORTRAN library will be found in the file SYSLIB.OBJ. 

The default FORTRAN library will be configured for the 

KKX hardware found on this machine. Is this accept ab 1 e? YO 

(where xxx is FIS if you have an 11/03 processor and FPU if you 

have an 11/23 processor). 

Is support for UIRTUAL arrays desired? 

If you have an 11/23 processor and more than 32k words of 
memory, answer to this question; otherwise, answer N . If you 
answer V, the following question also appears. 

Since you are running under the S J monitor* 

and you haye a KT-11 memory Management unit* the 

UIRTUAL support selected for the default library 

iss SJ/FB 

Is this acceptable? Ygl 

Do you wish an inline only 1 i b ra ry? NSeT) 

Should run -time checKs be made to insure all array 

references are contained within program bounds? NES) 
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Do you want SIHRT support in your lib.rary? NdH) 
The default FORTRAN library has been configured. 

Are any other FORTRAN libraries required? N(Eil) 

Type: @OUP:OTSBLD to initiate the actual building of the 
FORTRAN library(s) . 

STOP -- 

.@0UP:0TSBLD(1T) 

.R LIBR 

«OUP:SYSLIBC-1]:=OUP:SYSLIB .INPuFPU. 

INP:OTSCOM,INP:yiRNP tINP:MZS/G 

Global? $ERRS 

Global? $ERRTB 

Global? $OURH 

Global? 

#'C 

3.1 .5 Testing the Installed Compiler and OTS 

Perform the procedures for installation verification in the RT-11 
FORTRAN IV Installation Guide. 

3.1.6 Preserving tlie Development System Disk 

Preserve your development system disk, which contains the FORTRAN IV 
compiler and OTS, by executing the following instructions: 

1. Write-pro tect drive 0. 
Write-enable drive 1. 

Mount your development system backup disk in drive 1. 

2. Initialize the output disk by typing: 

. INITIALIZE/BADBLOCKS DLl:® 
DLli/ initialize; Are you sure? Yd!) 
?DUP-I-No bad blocks detected DLl: 

NOTE 

If the system finds bad blocks, see the discussion of the 
INITIALIZE command in the RT-11 System User's 
Guide for additional information. 

Copy the development system disk by typing: 

.S0UEEZE/0UTPUT:DL1 : DLO:iEl 

Copy the bootstrap by typing: 

.COPY/BOOT DLl jRTllyy ,SYB DLlsdl) 

where v ■/ is the name of the monitor in operation. 
Remove the disk from drive 1, and store it in a safe place. 
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3.2 Installing FORTRAN IV When Using Two RX02 Diskette Drives 

Read this section before you begin the FORTRAN IV installation proce- 
dures. This section contains information that will help you install and build 
FORTRAN IV. For further information, see the RT-11 FORTRAN IV 
Installation Guide. 

The FORTRAN IV installation procedure involves the following operations: 

1. Preparing for installation 

2. Preserving the distribution diskettes 

3. Patching the copied diskettes 

4. Building the compiler and OTS (Object Time System) on your develop- 
ment system diskette 

5. Testing the installed compiler and OTS 

6. Preserving the development system diskette 

The FORTRAN IV distribution kit contains three diskettes. They are: 

• The compiler diskette, which contains files for building the FORTRAN IV 
compiler 

• The OTS diskette, which contains files for building the 
FORTRAN IV OTS 

• The standard- software diskette, which contains a pre-built compiler and 
OTS library as well as optional FORTRAN IV modules 

3.2.1 Preparing to Install FORTRAN IV 

Before beginning the FORTRAN IV installation procedure: 

• Gather the following: 

RT-11 FORTRAN IV Installation Guide 

The RT-11 Autopatch Kit 

FORTRAN IV distribution diskettes 

Three blank RX02 diskettes 

The diskette onto which you have backed up your development system 

• Read the FORTRAN IV Installation Guide. 

• Create additional free space on the development system disk by deleting 
the RT-1 HELP file, HELP.SAV: 
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1. Bootstrap the development system disk in drive 0. 

2. Type the following command. (The NOQUERY option prevents the 
system from printing a confirmation message before it deletes the 
file.) 

.DELETE/NOPUERY HELP.SAUEH) 

3. Collect free space on the disk into one contiguous area by typing: 

♦ SQUEEZE SYidl) 

SQUEEZE: /Squeeze 5 Are you sure? YdH 

RT-llxH MiM.OO 

(followed by any startup file commands) 

where dv is DL if you have two RL01/RL02 disk drives or DY if you 
have only RX02 diskette drives 

X X is the name of the monitor in operation 

• Before installing FORTRAN IV software, be sure your development sys- 
tem disk contains at least the files listed in Table 3-1. 

3.2.2 Preserving the Distribution Disi<ettes 

Preserve the FORTRAN IV distribution kit by executing the following in- 
structions for each distribution diskette. (Use this procedure to preserve 
any diskette that does not contain the operating system.) 

1. Bootstrap your development system diskette in drive 0. 

Mount a blank diskette in drive 1. 

Format and initialize the disk in drive 1 by typing the following 
commands: 

.FORMAT DYl!® 

DYl: /FORMAT- A re you sureTY® 

?Format-I-ForMattiri9 coiiiplete 

.INITIALIZE/BADBLOCKS DYl:® 

Y 1 : / I n i t i a 1 i 2 e ; Are you sure? YdD 

?DUP-I-No bad blocKs detected DYl: 

NOTE 

If the system finds bad blocks, see the RT-11 System 
User's Guide for additional information on the 
INITIALIZE command. 

2. Type the following commands to copy the distribution diskette: 

.SC3UEEZE/0UTPUT:DY1 :/WAIT DYO:® 
Mount output yoluiiie in DYl:! Con t inue? Y® 
Mount input yolume in DYO: i Continue? 

) 

Remove the diskette from drive 0. 
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Mount the next diskette to be copied in drive 0. 

Type YdB . 

When the diskette is copied, the following message appears: 

Haunt system uoluwe in DYO:? Continue? 

Remove the diskette from drive and store it in a safe place. 

Remove the diskette from drive 1. 

Mount the system diskette in drive and type YdD . 

3.2.3 Patching the Copied Diskettes 

1. Be sure that the development system diskette is bootstrapped in drive 
and a copied FORTRAN distribution diskette is mounted in drive 1. 

2. Remove protection from files on the copied diskette by typing the fol- 
lowing command. (Use the NOLOG option to prevent a list of renamed 
files from appearing on the terminal.) 

.RENAME/SYSTEH/NOPROTECTION/NOLOG DYl:*,* DYl:*.*® 

Remove protection from each of the other copied FORTRAN distribu- 
tion diskettes. 

3. Apply the patches for FORTRAN IV by following instructions in the 
RT—11 Autopatch User's Guide. 

4. Bootstrap the development system diskette in drive 0, and mount a 
patched diskette in drive 1. Protect files on the patched diskette by 
typing the following command. (The NOLOG option prevents a list of 
renamed files from appearing on the terminal.) 

.RENAME/SYSTEH/PROTECTION/NOLOG DYl:*.* DYl:*.*® 

Protect files on each of the other patched diskettes. 

3.2.4 Building the Compiler and OTS 

Bootstrap the development system disk in drive 0. 

If you installed RT-11 by using the RT option of the FEP Installation 
Diskette, the development system diskette does not contain enough free 
space to accomodate the FORTRAN IV installation procedure; create free 
space on the development system diskette by typing the following 
commands: 

RT-llxK MOa.OO 

(followed by any startup file commands) 

where x x is the name of the monitor in operation 

.DELETE HELP. SAM®) 
.SQUEEZE DYO:® 
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Mount copied, patched FORTRAN IV distribution diskette 1 in drive 1. 

Use the following sample dialog as a guide to answering questions asked by 
the program that builds the compiler and OTS. (The dialog contains an- 
swers likely to be useful to you. For alternative answers, consult the RT-11 
FORTRAN IV Installation Guide.) 

.ASSIGN DYO: OUP® 

.ASSIGN DYl : INP® 

.RUN INPsFORGENSll) 

Answer <=iuestions with! 

"?" or carriage returri (<CR>) for i nf o rmat i on f 

YES(Y) for affirmation, anything else for NO. 



A iriaxiMLiM of 5B lines are allowed per listing paSe. 

Is this acceptable? Yd!) 

A maxifituM of 136 characters are allowed in a formatted 

(ASCII) record. Is this acceptable? Yd!) 

A m a X i w u M of B channels may be open at a S i y e n time. 

Is this acceptable? YdD 

The FORTRAN cowpiler can cciiipile s y s t eni- s pec i f i c OPEN and CLOSE 

statement Keywords for RT-11. RSX-ll* and RSTS/E systems. These 

statements are currently compiled for the follow! ns system: RT-11 

Is this acceptable? YdB 

Based on your system's hardware con figuration the default 

type of code generated by the FORTRAN compiler will be hkx. 

Is this acceptable? YdD 

(where xxx is FIS if you have an 11/03 processor or EIS if you 

have an 11/23 processor). 

Do you wish an inline only compiler? N® 

(You need a threaded compiler to use FDT.) 

Compiler options selection complete. 

Type: @OUP:FORBLD to initiate the actual building 
of the compiler. 

. eOUPiFORBLD® 



eiNPi 


iFaLINK 


.R LINK 


*DUP; 


sF0RTRA=INP5FROOT///S 


*INPi 


:F0 tOUPsDEFLTS/0:l 


*INPi 


:Fl/0: 1 


*INPi 


:F2/0: 1 


#INPi 


SF3/0! 1 


#INPi 


!F4/0! 1 


*INPi 


:F5/0!l 


*INPi 


:F6/0: 1 


*INP: 


:F7/0! 1 


*INPi 


iF8/0! 1 


#INPi 


:F9/0: 1 


#INP: 


:F10/0: 1 


*INPi 


:LOOP/0: 1 


*INPi 


:Fll/0: 1 


*INPi 


:FlZ/0: 1 


*INPi 


!CONURT/0!l 


#INP: 


:REGALD/0:1 


*INP 


:F14/0: 1 
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#INP:F20/0!l 
*INP!F19/0:1 
#INP:F21/0!l 
«INP:PEEP/0:1 
#INP:OBJGSD/0! 1 
*INP!F18/0!l 
#INPiiF13/0! 1 
*INPiF15/0!l 
»INP:FlB/0! 1 
*INP!F17/0: 1 
*INP:CDUriP/0: 1// 

Remove the diskette from drive 1. Mount the copy of the second FORTRAN 
IV distribution diskette in drive 1. 

.RUN INPsOTSGENdl) 

Answer questions with: 

"?" or carriage return (<CR>) for information t 

YES( Y) for af f i rmation t an-zthinS else for NO. 



The following questions refer to the buildinS of the 
default FORTRAN library. 

The FORTRAN library components are rioriiially added to 

the default RT-11 system library filet SYSLIB.OBJ. 

Is this acceptable? Yd!) 

The default FORTRAN library will be found in the file SYSLIB.OBJ, 

The default FORTRAN library will be confi3ured for the 

KXK hardware found on this machine. Is this ac cept ab 1 e? YdlB 

(where xxx is FIS if you have an 11/03 processor and FPU if you 
have an 11/23 processor). 

Is support for UIRTUAL arrays desired? 

If you have an 11/23 processor and more than 32k words of 
memory, answer y to this question; otherwise, answer N . If you 

answer Y, the following question also apjpears. 

Since you are running under the SJ monitor t 
and you have a KT-11 memory wanaSement unitt the 
MIRTUAL support selected for the default library 
is! SJ/FB 

Is this acceptable? YdD 

Do you wish an inline only library? NE) 

Should run -time checks be made to insure all array 

references are contained within prosram bounds? N(MD 

Do you wish SIMRT support in your library? N(Hl 

The default FORTRAN library has been configured. 

Are any other FORTRAN libraries requi red? N® 

Types BOUPsOTSBLD to initiate the actual buildins of the 
FORTRAN libra ry(s) . 

STOP -- 
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♦ iOUPiOTSBLD® 

.R LI BR 

*OUP!SYSLIB[-l]i=OUP:SYSLIB.INP!FPU, 

INPiiOTSCOM,INPsgiRNP »INP!M2S/G 

Global? $ERRS 

Global? *ERRTB 

Global? $OURH 

Global? 

#-c 

3.2.5 Testing the Installed Compiler and OTS 

Perform the procedures for installation verification in the RT-11 
FORTRAN IV Installation Guide. 

3.2.6 Preserving the Development System Diskette 

Preserve your development system diskette, which contains the FORTRAN 
IV compiler and OTS, by executing the following instructions: 



1. 



Mount your development system backup diskette in drive 1. 



2. Initialize the output diskette by tj^jing: 

.INITIALIZE/BADBLOCKS DYl:® 
DYl s/INITIALIZE; Are you sure? YdH 
?DUP-I-No bad blocks detected DYl: 

NOTE 

If the system finds bad blocks, see the RT-11 System 
User's Guide for additional information on the 
INITIALIZE command. 

Copy the development system diskette by typing: 

.SQUEEZE/OUTPUT.-DYl : DYO:® 

Copy the bootstrap by typing: 

.COPY/BOOT DYl:RTllyy,SYS DYl:® 

where y y is the name of the monitor in operation. 

Remove the diskette from drive 1, and store it in a safe place. 
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Chapter 4 

Installing the FEP/FRP Laboratory Software 



This chapter contains detailed step-by-step instructions for installing the 
FEP/FRP Laboratory Software. All FEP/FRP component manuals, except 
the REAL-lllMNC FORTRAN Programmer's Reference Manual and the 
RGLIll Programmer's Reference Manual, also contain similar installation 
instructions. Follow the instructions in this chapter rather than those in 
the individual FEP/FRP component manuals; the instructions in this 
chapter provide help in using RL01/RL02 disks and RX02 diskettes 
whereas the instructions in the FEP/FRP component manuals do not. 

To install the FEP/FRP Laboratory Software, perform the following proce- 
dures, all of which are described in this chapter: 

1. Preserve all distribution media that contain FEP/FRP Laboratory 
Software. 

2. Patch and preserve the copied disks. 

3. Install and verify a FEP/FRP Laboratory Software component. 

4. Preserve your development system disk. 

Repeat steps 3 and 4 until you have installed all the components you need. 
(See Figure 4-1 for an overview of the installation procedure.) 

NOTE 

The FEP/FRP Laboratory Software components are indepen- 
dent of each other. Install only the components you need; if 
you will use only one of them, you need to install only that 
one. 

Section 4.1 tells you how to copy and patch the distribution media. Sections 
4.2 through 4.7 tell you how to install, verify, and preserve each FEP/FRP 
component. Section 4.8 contains optional procedures for deleting the 
MACRO assembler. 



4-1 



Figure 4-1: Installing FEP/FRP 
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4.1 Preparing to Install the FEP/FRP Laboratory Software 

Before you begin the FEP/FRP Laboratory Software installation 
procedures: 

• Gather the following: 

Copies of the RT-11 software dispatch 

FEP/FRP Laboratory Software distribution media 

One blank RLOl or RL02 disk (if you have RLOl or RL02 disk drives) 

Fifteen blank RX02 diskettes (if you have RX02 diskette drives) 

The disk onto which you have backed up your development system 

• Be sure your development system disk contains at least the files listed in 
Table 4-1. 

• If you have only RX02 diskette drives, create a new development system 
diskette by performing the following instructions: 

1. Bootstrap the development system disk in drive 0. 
Mount a blank diskette in drive 1. 

Format the diskette in drive 1 by typing the following commands: 

.FORMAT DYliHl) 

DYl :/FORMAT-Are you sure?Y(ll) 

?Fo rmat-I -Fo rmatt in S complete 

2. Follow the instructions in Section 3.2.6 for preserving the develop- 
ment system diskette. 

Remove the diskette from drive and store it in a safe place. After 
you have installed all needed FEP/FRP software, you can use this 
diskette as a system diskette for program development. 

Move the other diskette from drive 1 to drive 0. 

Bootstrap the diskette in drive 0. 

3. Create additional free space on the diskette by using the DELETE 
command to delete all files not listed in Table 4-1. Use this diskette 
as the development system diskette for installing FEP/FRP 
Laboratory Software. 

• Collect free space on the disk into one contiguous area by typing: 

♦ SQUEEZE SY:® 

d u : / S =1 u e e z e ; Are you sure? Y® 

RT-llxK MO^.OO 

(followed by any startup file commands) 
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where d y is dl if you have two RL01/RL02 disk drives or dy if you have 
only RX02 diskette drives 

X X is the name of the monitor in operation 

• If you have only RX02 diskettes, create the FEP Library Diskette by 
performing the following procedures: 

1. Mount a blank diskette in drive 1. 

Format and initialize the disk in drive 1 by typing the following 
commands: 

.FORMAT DYlsdJ 

DYl s/FORMAT-Are you sure?Y(lIl 

?For(tiat-I-ForMattindoo(iiplete 

. INITIALIZE/BADBLOCKS DYl:® 
D Y 1 s / I n i t i a 1 i z e i A r e you sure? YdD 
?Dup-I-No bad blocks detected DYl: 

NOTE 

If the system finds bad blocks, see the RT-11 System 
User's Guide for additional information on the 
INITIALIZE command. 

2. Remove the diskette from drive 1. This is the FEP Library Diskette. 
Installation instructions for all FEP/FRP Laboratory Software in- 
clude copying installed software to this diskette. 

Table 4-1: Minimal Softv»rare Needed for Installing FEP/FRP 



File 


Comment 


RTllSJ.SYS 


If you want to use the SJ monitor. 




RTllFB.SYS 


If you want to use the FB monitor. 




DL.SYS 


If you have two RL01/RL02 disk drives. 




DY.SYS 


If you have only RX02 diskette drives. 




LP.SYS 


If you have a parallel line printer, such 


as an LA180. 


LS.SYS 


If you have a serial line printer, such as 


an LA120. 


TT.SYS 






SWAP.SYS 






CREF.SAV 






DIR.SAV 






DUP.SAV 






FORMAT.SAV 






LIBR.SAV 






LINK.SAV 
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Table 4-1: Minimal Software Needed for Installing FEP/FRP 
(Cont.) 



File 


Comment 


MACRO.SAV 




PIP.SAV 




RESORC.SAV 




SYSMAC.SML 




STARTS.COM 


If you have included RTllSJ.SYS. 


STARTF.COM 


If you have included RTllFB.SYS. 


SYSLIB.OBJ 


Which includes the FORTRAN OTS if you have not added 




FORLIB.OBJ as a separate library. 


FORLIB.OBJ 


If you have not added the FORTRAN OTS to SYSLIB. 


FORTRA.SAV 





4.1.1 Preserving the Distribution IVIedia 

If you have two RL01/RL02 disk drives, you have already preserved the 
FEP/FRP distribution disk by following procedures in Section 2.2.1. 

If you have only RX02 diskette drives, preserve the distribution diskettes 
that contain the FEP/FRP Laboratory Software by following the instruc- 
tions in Section 3.2.2. However, when initializing diskettes onto which you 
will copy the SSP software, use the following form of the INITIALIZE 
command: 

.INITIALIZE/BADBLaCKS/SEGMENTS:5 DYl -.m 

This form of the command creates a directory large enough to accommodate 
the SSP software. For more information on the INITIALIZE command and 
the SEGMENTS option, see the RT-11 System User's Guide. 

4.1.2 Patcliing tlie FEP/FRP Laboratory Software 

Install all FEP/FRP patches contained in the RT-11 Software Dispatch. 
Before installing patches, remove protection from files on the copied distri- 
bution disk by typing the following command. (Use the NOLOG option to 
prevent a list of renamed files from appearing on the terminal.) 

.RENAME/SYSTEM/NOPROTECTION/NOLOG dMl:*.# d M 1 : * . #(11) 

After installing patches, protect files on the patched disk by typing the 
following command. (Use the NOLOG option to prevent a list of renamed 
files from appearing on the terminal.) 
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.RENAME/SYSTEH/PROTECTION/NDLOG dMl:*.* d u 1 : * . *(1T) 

where du is dl if you have two RL01/RL02 disk drives or DY if you have 
only RX02 diskette drives. 
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The FEP/FRP distribution kit contains standard REAL-11/MNC library 
files as well as programs for customizing the REAL-11/MNC software. 
Read Section 4.2.1 and decide if one of the distributed library files fulfills 
your needs. If one of the distributed REAL-11/MNC library files is satisfac- 
tory, perform the installation procedures described in this chapter. Other- 
wise, perform the REAL-11/MNC Software Generation Procedure 
(MNCGEN), described in Appendix A. 

NOTE 

MNCGEN is a time-consuming procedure; perform it only if 
the distributed software does not satisfy your needs. 

4.2.1 Selecting a REAL-11/MNC Library File 

The FEP/FRP distribution kit contains two REAL-11/MNC library files: 

• MNCMUL.OBJ supports multiple (simultaneous) clock-driven 

sweeps, which are two or more sweeps controlled 
or "driven" by the real-time clock. For example, 
if the real-time clock drives A/D and D/A sweeps 
that are running simultaneously, the sweeps are 
said to be multiple clock-driven sweeps. How- 
ever, if the real-time clock drives an A/D sweep 
that is running concurrently with an interrupt- 
driven digital-input sweep, the sweeps are not 
multiple clock-driven sweeps. For further infor- 
mation, see the REAL-lllMNC FORTRAN 
Programmer's Reference Manual. 

• MNCSNG.OBJ does not support multiple clock-driven sweeps 

The following list describes features common to both distributed REAL-11 
library files. Both files: 

• May be added to an existing library. 

• Check for the presence of required MNC-series hardware each time a 
REAL-11/MNC subprogram is executed. 

• Require you to set CSR and vector address switches on MNC-series mod- 
ules to the default settings (see the chapter on system configuration in 
the DECLAB-11/MNC User's Guide.) 

• Support any number of MNC-series modules up to the maximum. 
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• Support two Serial Line Units (SLUs). 

• Stop sweeps on a data overrun. 

• Use a value of STTTTg, which is decimal 16383, to indicate an error in the 
execution of any routine that acquires analog data. (REAL— 11 places 
377778 ill the input buffer if the execution of any routine that acquires 
analog data results in a data overrun.) 

• Use a value of 1777778 to indicate an error in the execution of DISWP. 
REAL-11 places 1777778 in the input buffer if the execution of DISWP 
results in a data overrun. 

• Contain the GTHIST subprogram. 

• Are supported under the RT-11 single-job, foreground/background, and 
extended-memory monitors. (See Section 6.6 for restrictions related to the 
use of the extended-memory monitor.) 

• Supply a default gain value of 0.50 for the subprograms that acquire 
analog data. 

• Use an input ring buffer of 82 bytes for the CIN subprogram. 

• Use an output ring buffer of 40 bytes for the COUT subprogram. 

Select a REAL-11/MNC library file to use at your installation. Choose 
MNCMUL.OBJ only if you will execute multiple clock-driven sweeps. 
Choose MNCSNG.OBJ if you will not execute multiple clock-driven sweeps. 
Choose carefully; using MNCMUL.OBJ causes any clock-driven sweep to 
execute more slowly than it would if you used MNCSNG.OBJ. If neither 
MNCMUL.OBJ nor MNCSNG.OBJ appears to satisfy your needs, consult 
Appendix A of this manual and perform the software-generation procedure 
to customize the REAL-11/MNC software. The version of REAL-11 pro- 
duced by the software-generation procedure is named MNCLIB.OBJ. 

4.2.2 Adding a Distributed REAL-11 /MNC Library to the 
System Disk 

To include distributed REAL-11/MNC software on the system disk, per- 
form the following procedures: 

1. See Table 4-1 to verify that you have the minimal software needed for 
installing FEP/FRP. 

2. Bootstrap the development system disk in drive 0. 

If you have two RL01/RL02 disk drives, mount the copied, patched 
FEP/FRP distribution disk in drive 1. 

If you have only RX02 diskette drives, mount copied, patched 
REAL^ll/MNC distribution diskette number 1 in drive 1. 
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3. Copy a distributed REAL-11/MNC library to the development system 
disk by typing one of the following: 

(In the following instructions, for dv, tjrpe DL if you have two 
RL01/RL02 disk drives or DY if you have only RX02 diskette drives.) 

.COPY dMl sMNCMUL.OBJ duO : MNCMUL . OB J® 
.COPY dMl sMNCSNG.OBJ dyO s MNCSNG . OB JED 

4. When you have installed all needed FEP/FRP software, see Section 5.6 
for information on using the librarian to add files to SYSLIB. 

4.2.3 Verifying Distributed REAL-H/IVINC Software 

This section contains instructions for verifying a library that contains one 
of the two distributed REAL-11/MNC library files. For instructions on ver- 
ifying REAL-11/MNC software that you have generated yourself (by per- 
forming the MNCGEN procedure), see Appendix A. 

To verify distributed REAL-11/MNC software: 

1. You must be using the SJ or FB monitor. You also must execute the 
procedure on the system console terminal. 

2. In drive 0, mount a system disk that contains both a distributed 
REAL-11/MNC library file and at least 100 contiguous free blocks. 

If you have two RL01/RL02 disk drives, mount the copied, patched FEP 
distribution disk in drive 1. 

If you have only RX02 diskette drives, mount copied, patched 
REALr-11/MNC diskette number 1 in drive 1. 

3. The clock Schmitt triggers can generate outputs in response to electri- 
cal noise when no device is connected to the input. To avoid such spuri- 
ous responses from unused Schmitt triggers, set the mode selector of 
each MNCKW clock module to VAR and turn the associated potentio- 
meter to either of its extreme settings. 

Also, be sure no instruments are connected to the MNC-series modules. 

4. Assign logical device names needed by the verification procedure by 
typing: 

.ASSIGN dyn: N:® 
.ASSIGN dyl: I:® 

where du is dl if you have two RL01/RL02 disk drives and DY if you 
have only RX02 diskette drives. 

n is if you have two RL01/RL02 disk drives and 1 if you 
have only RX02 diskette drives. 
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5. The verification procedure creates (and deletes) on device N: files 
named MVERN.OBJ and MTMP.RUN. Therefore, if you have any files 
with those names on device N:, rename them before you begin the veri- 
fication procedure. 

6. Execute the verification procedure that tests the distributed 
REAL-11/MNC library file installed on device N:. If you have installed 
MNCSNG.OBJ, verify that software by running MNCSNG.VER. If you 
have installed MNCMUL.OBJ, run MNCMUL.VER. Type: 

• @I ! f i lenatite .MER(BS) 

where f i lename is MNCSNG or MNCMUL 

7. As the verification procedure tests the REAL-11/MNC software, it 
prints messages on the console terminal. The following list contains the 
types of messages and an example of each: 

• Confirmation messages, which verify that an MNC-series module 
and some related REAL-11/MNC software have been exercised suc- 
cessfully. For example: 

The primary clocK (1st HNCKW) and some related REAL-11 software 
have been exercised successfully! 

• Level-W error messages, which indicate that hardware named in the 
message is absent. For example: 

?MUER-W-The REAL-11 software has NOT detected an analoS to 
digital input module (HNCAD) in this system. 

• Level-F error messages, which are fatal error messages indicating 
that the software has malfunctioned. One type of fatal error message 
names the verification module that has failed. For example: 

?MMER-F-REAL Software Error - Installation failure at PSDI 

Another type of fatal error message lists trouble-shooting aids for 
DIGITAL support personnel. For example: 

?HUER-F-#**UNEXPECTED ERROR DURING HNCAA RELATED PHASE*** 
#*»CHECK HARDWARE I/O SIGNALS*** 

Trouble-shootins aids for DIGITAL support: 

a) IND = 1 

b) INFQ(l) = 33a 

• The completion message: 

STOP -- UERIFICATION PROCESS COMPLETE 

8. When the console terminal displays the system dot, evaluate the results 
of the verification procedure: 

• If the terminal has displayed only a series of confirmation messages 
followed by the completion message, then the REAL-11/MNC soft- 
ware and MNC-series hardware are correctly installed. 
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• If the terminal has displayed any level-W messages, then 
MNC-series hardware is absent. If a level-W message names an 
MNC-series module that is present in your system, be sure that mod- 
ule's vector and CSR address switches are correctly set, then execute 
the verification procedure again. Ignore level-W messages that name 
MNC-series hardware not present in your system. 

• If the terminal has displayed any level-F messages, then the software 
has malfunctioned; call the MINC Product Services Center for further 
information. 

• If the terminal has displayed a series of messages but has not printed 
the completion message, then the software has malfunctioned; call 
the MINC Product Services Center for additional information. 

4.2.4 Completing the Installation of REAL-11/MNC 

If you have two RL01/RL02 disk drives, follow the instructions in Section 
3.1.6 for preserving your development system disk. 

If you have only RX02 diskette drives, add the installed REALr-11/MNC 
software to the FEP Library Diskette and remove that software from the 
development system diskette: 

1. Remove the diskette from drive 1. 

Mount the FEP Library Diskette in drive 1. 

2. Type: 

.COPY DYO: f i lename .OBJ DY 1 : f i 1 en awe .QBJdl) 
♦ DELETE/NOOUERY DYO : f i 1 en awe , OBJ® 

where filename is MNCMUL or MNCSNG 

4.3 Installing the Instrument Bus Subroutines (IBS) 

The FEP/FRP distribution kit contains five standard IBS files. These files 
are the IBS library (IBLIB.OBJ) and the four device handlers 
(IBMNC.SYS, IBNMNC.SYS, IBXMNC.SYS and IBXNMC.SYS). 

4.3.1 Adding the IBS Library and Driver to Your System 

To install the IBS software: 

1. See Table 4-1 to verify that you have the minimal software needed for 
installing FEP/FRP. 

2. Under some circumstances you must build a customized device handler 
and IBS library. You must do so if one or more of the following condi- 
tions are true: 
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• You have performed the RT-11 SYSGEN process by using the RT-11 
Installation and System Generation Guide, which is mentioned in 
Section 2.5.3 of this manual. (If you have installed the XM monitor by 
using the SYSGEN option described in Sections 2.5.1 and 2.5.2, you 
need not build a customized device handler and IBS library.) 

• You have more than one IBVll-A bus unit. 

• The IBVll-A vector address switch is not set to the standard value, 
octal 420. 

• The IBVll-A CSR address switch is not set to the standard value, 
octal 171420. 

If you need to build a customized device handler and IBS library, do so 
now by following the procedures in Appendix C, Building a New 
IBVll-A Device Handler and IBS Library, in the Instrument Bus 
Subroutines Programmer's Reference Manual. 

3. Bootstrap the development system disk in drive 0. 
Mount the disk that contains the device handler in drive 1. 

4. If you already have an IB handler on your development system disk, 
remove it by typing: 

• UNLOAD IB® 
. REMOVE IBdl) 

5. Copy the device handler to the development system disk, but before 
doing so, be sure that the development system contains enough contigu- 
ous, free blocks to accommodate the device handler. If you are using the 
SJ or FB monitor, the development system disk must contain at least 
nine contiguous, free blocks. If you are using the XM monitor, the de- 
velopment system disk must contain at least ten contiguous, free 
blocks. To copy the device handler to the development system disk, 
type: 

.COPY/SYSTEM d i.i 1 : d eu hn d dyO : d r i m . SYSES) 

where dw is DL if you have two RL01/RL02 disk drives or dy if 

you have only RX02 diskette drives 

d e y h n d is one of the following: 

IBMNC.SYS if you are installing the distributed device 
handler and are using the distributed SJ or FB 
monitor; 

IBXMNC.SYS if you are installing the distributed device 
handler and are using the distributed XM monitor; 

IB.SYG if you have built a customized device handler. 
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d r i u is one of the following: 

I B if you are using the SJ or FB monitor; 

IBX if you are using the XM monitor. 

The following message may appear on your terminal after you have 
copied the device handler: 

?PIP-W-Reboot 

Ignore this message. 

6. Be sure the disk that contains the IBS library file, IBLIB.OBJ, is 
mounted in drive 1. 

7. Copy the library file to the development system disk, but before you do 
so, be sure that the development system disk contains enough contigu- 
ous, free blocks to accommodate the library file. If you are using the SJ 
or FB monitor, the development system disk must contain at least 48 
contiguous, free blocks. If you are using the XM monitor, the develop- 
ment system disk must contain at least 56 contiguous, free blocks. To 
copy the library file to the development system disk, tjrpe: 

.COPY dul : IBLIB.OBJ dyO: IBL I B . OB JES 

where du is DL if you have two RL01/RL02 disk drives or DY if 

you have only RX02 diskette drives. 

You have now installed IBLIB.OBJ, the library of instrument-bus sub- 
routines. IBLIB.OBJ is the name of the library of instrument-bus sub- 
routines regardless of whether you have customized that library or 
have installed the distributed library. IBLIB.OBJ is also the name of 
the library regardless of whether you are using the SJ, FB, or XM 
monitor. 

8. Install and load the device handler by typing: 

, INSTALL IB®) 
.LOAD IBdl) 

9. Add the following command to the startup command file for the monitor 
you are using: 

LOAD IB 

If you are using the SJ monitor, add the command to STARTS.COM. If 
you are using the FB monitor, add the command to STARTF.COM. If 
you are using the XM monitor, add the command to STARTX.COM. 

The LOAD IB command will execute correctly only if the IB handler is 
installed. Each time you boot your system, the IB handler is automat- 
ically installed if all the following conditions are true: 

• The IB handler is on the system disk. 

• The IBVll-A bus unit is connected to the system. 
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• The monitor's device table has enough slots for each type of device 
connected to the system. 

See Section 2.5 for information on the possible need for IBS users to 
increase the number of slots in the monitor's device table by performing 
a SYSGEN. 

10. When you have installed all needed FEP/FRP software, see Section 5.6 
for information on using the librarian to add files to SYSLIB. 

4.3.2 Verifying IBS 

To verify IBS, perform the procedures in Section 4.4, Verifying Your 
Instrument Bus Subroutines Software, in the Instrument Bus Subroutines 
Programmer's Reference Manual. 

4.3.3 Completing the Installation of IBS 

If you have two RL01/RL02 disk drives, follow the instructions in Section 
3.1.6 for preserving your development system disk. If you have only RX02 
diskette drives, follow the instructions in Section 3.2.6 for preserving your 
development system diskette. 

If you have only RX02 diskette drives, add the installed IBS library to the 
FEP Library Diskette and remove that library from the development sys- 
tem diskette: 

1. Remove the diskette from drive 1. 

Mount the FEP Library Diskette in drive 1. 

2. Type: 

.COPY DYO! IBLIB.OBJ DY 1 : IBL I B . OB Jdl) 
.DELETE/NOQUERY DYO: IBLIB.OBJ® 

4.4 Installing the Scientific Subroutines Package (SSP) 

The SSP distribution media contain three different types of files needed for 
installing and verifying SSP. The files are: 

• FORTRAN IV source files (file type .FOR), some containing SSP subrou- 
tines, and others containing test programs executed by the indirect com- 
mand files 

• Indirect command files (file type .COM), each of which verifies at least 
one SSP subroutine 

• Data files (file type .DAT), which contain test data used by the test 
programs 
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The Scientific Subroutines Programmer's Reference Manual contains lists of 
these files. For an alphabetical list of the Scientific Subroutines, see 
Appendix C, Alphabetical Index of Subroutines, in that manual. For a list 
of indirect command files, related SSP source files, test program source 
files, and data files, see Table A-1, The Indirect Command Files, in that 
manual. 

4.4.1 Preparing to Add SSP to Your System 

Before you add SSP to your system: 

1. See Table 4-1 to verify that you have the minimal software needed for 
installing FEP/FRP. 

2. Choose the SSP subroutines you need. Add to your system and verify 
only those subroutines you actually need. SSP contains more than 100 
subroutines; verifying all of them is a lengthy procedure. In addition, 
adding unneeded software to your development disk wastes space. 

3. Write-enable drive (if you have two RL01/RL02 disk drives). 
Write-protect drive 1 (if you have two RL01/RL02 disk drives). 
Bootstrap the development system disk in drive 0. 

4. The verification procedure described in Section 4.4.2 requires you to 
assign input and temporary storage devices. To assign those devices, 
type: 

.ASSIGN duOs TM® 
. ASSIGN dul ! INdSl 

where dy is dl if you have RL01/RL02 disks or DY if you have RX02 
diskettes 

The verification procedures use available space on the development sys- 
tem disk as temporary storage space. (When the verification procedure 
is complete, that space again is free.) 

4.4.2 Verifying and Compiling SSP Subroutines 

To verify an SSP subroutine: 

1. Choose an SSP subroutine you plan to install. Mount in drive 1 the 
copied distribution disk containing that subroutine. (This disk also con- 
tains indirect command files, test programs, and data files needed to 
verify the subroutine.) 

2. Consult Table A-1, The Indirect Command Files, in the Scientific 
Subroutines Programmer's Reference Manual. In that table, find the 
name of the subroutine you plan to install. Determine how many con- 
tiguous blocks must be on the development system disk for verifying 
the subroutine. If the disk does not have enough contiguous space, 
create more contiguous space by typing: 
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• SQUEEZE dMO:(RET) 

where dv is DL if you have two RL01/RL02 disk drives or dy if you 
have only RX02 diskette drives 

3. The verification procedure deletes all files on the development system 
disk named TMPSSP. Therefore, if you have any files on your develop- 
ment system disk with that name, rename them. (See the RT-11 
System User's Guide for information on the RENAME command.) 

4. Again, see Table A-1, The Indirect Command Files, in the Scientific 
Subroutines Programmer's Reference Manual. In that table, find the 
name of the subroutine you plan to install and the name of the indirect 
command file that verifies it. Run the indirect command file by typing: 

.§di.il : f i le® 

where file is the name of the indirect command file 

The indirect command file runs a test program that performs computa- 
tions and prints data and a message on your terminal. The indirect 
command file also deletes temporary files it has created. 

5. If the test program executes successfully, it prints a confirmation mes- 
sage such as: 

STOP -- file Merificatiori procedure successful 

where file is the name of the indirect command file you ran 

If that message has appeared, add the tested subroutine to the develop- 
ment system disk by typing: 

.FORTRAN/OBJECT :dyO: d y 1 : f i 1 en awedB 

where d ... is dl if you have two RL01/RL02 disk drives or DY if 

you have only RX02 diskette drives 

filename is the name of the tested SSP subroutine 

If the test program has printed an error message, determine the cause 
of the error. Some conditions that can cause errors are: 

• A required program such as the FORTRAN IV compiler, the RT-11 
linker, PIP, or DUP is not on your system device. 

• You assigned the input device incorrectly. That is, the device you 
assigned to be the input device does not contain the volume where 
input files from the Scientific Subroutines reside. 

• You assigned the output device incorrectly. That is, the device you 
assigned to be the output device does not have enough contiguous 
storage space. 

• Your system device or your input or output device was write- 
protected when you tried to run an indirect command file. 
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If an indirect command file cannot run even though you have not made 
errors of this kind, you may have received a defective copy of the 
Scientific Subroutines software. If that is the case, contact your MINC 
phone support center for more information. 

Verify and compile the other SSP subroutines you plan to use. 

4.4.3 Completing the Installation of SSP 

If you have two RL01/RL02 disk drives,see Section 5.6 for information on 
using the hbrarian to add files to SYSLIB after you have installed all 
needed FEP/FRP software. Follow the directions in Section 3.1.6 for pre- 
serving the system disk. 

If you have only RX02 diskette drives, mount the FEP library diskette in 
drive 1. Use the COPY command to add the installed SSP object files to the 
FEP Library Diskette, then use the DELETE command to remove SSP 
object files from the development system diskette. 

4.5 installing tiie Laboratory Subroutine Paclcage (LSP) 

The FEP/FRP distribution kit contains standard LSP software as well as 
files for installing and customizing that software. To install the software, 
execute the LSP interactive build procedure, LSPMAK.SAV, which is de- 
scribed in Section 4.5.1. Select from the following types of options as you 
perform the procedure: 

• Library options, which let you place the subroutines in a new library with 
a name of your choosing. 

• Hardware options, which let you make use of your extended-arithmetic 
hardware. 

• Subroutine and algorithmic options, which let you specify the subroutines 
and algorithmic options you need. 

The interactive build procedure creates the following files on the develop- 
ment system disk: 

• LSPCND.MAC, which sets switches that enable the options you have 
requested. 

• LSPBLD.COM, an indirect command file that builds the subroutines. 
("Building" means assembling subroutines with switches set to enable 
the algorithmic options you have chosen and optionally adding those sub- 
routines to a library you have selected.) 

• LSPVER.COM, an indirect command file that verifies the installed LSP 
software by running an example program for each assembled subroutine. 
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4.5.1 Building tiie LSP Software 

To execute the LSP interactive build procedure: 

1. See Table 4-1 to verify that you have the minimal software needed for 
installing FEP. 

2. Write-enable drive (if you have two RL01/RL02 disk drives). 

Write-protect drive 1 (if you have two RL01/RL02 disk drives). 

Mount the development system disk in drive 0. 

Mount the copy of the FEP/FRP distribution disk that contains LSP in 
drive 1. 

3. The build procedure requires you to assign input and output devices. To 
assign those devices, type: 

• ASSIGN di.iO: OU:® 

• ASSIGN dMl: IN:® 

where dv is DL if you have RL01/RL02 disks or dy if you have RX02 
diskettes 

4. Begin the interactive build procedure by typing: 

• RUN INsLSPHAK® 

Answer all questions displayed on your terminal during the procedure. 
If you have only RX02 diskette drives, answer Y to the question that 
asks whether you want to build a new library; name the library 
DY:LSPLIB.OBJ. Regardless of which type of disk drives you have, 
answer Y to the question that asks whether your machine has the EIS 
option or a floating point option. For a listing of the dialog, see 
Appendix C (Sample of the Interactive Build Procedure for RT-11, 
LSPMAK.SAV) in the Laboratory Subroutines Programmer's Reference 
Manual. 

5. When the dialog is complete and your terminal displays the monitor 
dot, run the indirect command file LSPBLD.COM, which builds the 
software. Type: 

• eOUsLSPBLD® 

4.5.2 Verifying tlie LSP Software 

To verify the LSP software: 

1. Run the indirect command file, LSPVER.COM, which verifies each LSP 
subroutine built by the indirect command file, LSPBLD.COM. Tj^e: 

.eOU:LSPUER® 
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LSPVER executes example programs that test the installed LSP soft- 
ware. As each program is executed, the terminal displays the name of 
the program and some output. These programs and the correct output 
are listed throughout the Laboratory Subroutines Programmer's 
Reference Manual. 

To determine whether your software is correctly installed, compare the 
results of LSPVER with the results of the example programs in the 
Laboratory Subroutines Programmer's Reference Manual. If your re- 
sults are the same as those in that manual, LSP is correctly installed. If 
not, install the LSP software again. 

4.5.3 Completing the Installation of LSP 

If you have two RL01/RL02 disk drives, follow the instructions in Section 
3.1.6 for preserving your development system disk. 

If you have only RX02 diskette drives, add the installed LSP software to 
the FEP Library Diskette and remove that software from the development 
system diskette: 

1. Remove the diskette from drive 1. 
Mount the FEP library diskette in drive 1. 

2. Type: 

.COPY DYOsLSPLIB.OBJ DY 1 : LSPL I B . OB Jill 
. DELETE/NOQUERY DYO ! LSPL I B , DB J® 

4.6 Installing the FORTRAN Debugging Technique Software (FDT) 

The FEP/FRP distribution kit contains three FDT files: 

• FDT. MAC, the software in source form 

• FDT.OBJ, the software in assembled form 

• FDTVER.FOR, a FORTRAN source file used for testing FDT 

4.6.1 Adding FDT to Your System 

To install FDT: 

1. See Table 4-1 to verify that you have the minimal software needed for 
installing FEP/FRP. 

2. Bootstrap the development system disk in drive 0. Mount the copy of 
the FEP/FRP distribution disk that contains FDT in drive 1. 
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3. Copy the FDT object file to the development system disk by typing the 
following command: 

• COPY diJlsFDT.OBJ duO : FDT , OBJ® 

where dy is dl if you have two RL01/RL02 disk drives or dy if you 
have only RX02 diskette drives. 

4.6.2 Verifying tlie FDT Software 

To verify your FDT software: 

1. Bootstrap the working system disk in drive 0. 

Mount the patched copy of the FEP/FRP distribution disk that contains 
FDTVER.FOR in drive 1. 

2. Type the commands in the following dialog: 

(In the following instructions, for dv, type DL if you have RL01/RL02 
disks; type DY if you have RX02 diskettes.) 

.FORTRAN/CODE: THREADED/LI ST ;TT: /OBJECT :FDTMER d u 1 : FDTUERdi) 
FORTRAN IM M02,5-ll 



0001 




DATA B ,C .J tM/1. .0. tl ,1000/ 


0002 


1 


A = C 


0003 




N = M 


0004 


2 


A = A+B 


0005 




N = N-1 


OOOB 




IF(N.GT,0) GO TO 2 


0008 




TYPE 1000, A ,B,M 


0009 


1000 


FORMAT*// ' FINAL MALUE = ' dPEl 




1 ' 


STEPS = ' 15,//) 


0010 




IF( J.NE.O) GO TO 1 


0012 




STOP 'FINISHED PROGRAM' 


0013 




END 


.MAIN. 







1PE15.5.' INCREMENT = 'E15.5, 



FORTRAN IM Storage Map for ProSraw Unit .MAIN. 

Local Variables, . PSECT $DATA , Size = 000024 ( 10. words) 

Name Type Offset Name Type Offset Name Type Offset 
A R#4 0000 IB B R*4 000002 C R#4 OOOOOB 
J I #2 000012 M 1*2 000014 N 1*2 000022 

• LINK FDTMER ,FDT@il) 

,RUN FDTMER® 
FDT 002-02 

FDT PAUSE AT ISN 2 IN .MAIN. 

NAME J, 12® 
NAME M,14(l!) 
PAUSE ,10® 
START® 

FINAL UALUE = l.OOOOOE+03 INCREMENT = l.OOOOOE+00 STEPS = 1000 
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FDT PAUSE AT ISN 10 IN .MAIN, 
! ACCEPT M = 5000(M) 

ICONTINUEdl) 

FINAL VALUE = 5.00000E + 03 INCREMENT = 1 .OOOOOE + 00 STEPS = 5000 

FDT PAUSE AT ISN 10 IN .MAIN. 
! ACCEPT J = 0(lil 

! CONTINUE® 

STOP - FINISHED PROGRAM 

3. Compare the computer responses printed by your printer with the com- 
puter responses in the preceding dialog. If the responses do not match 
and if you are sure you have correctly installed FDT, then you may 
have received unreliable software. Consult the MINC Product Services 
Center for further information. 

4.6.3 Completing the Installation of FDT 

If you have two RL01/RL02 disk drives, follow the instructions in Section 
3.1.6 for preserving your development system disk. 

If you have only RX02 diskette drives, add the installed FDT software to 
the FEP Library Diskette and remove that software from the development 
system diskette: 

1. Remove the diskette from drive 1. 

Mount the FEP Library Diskette in drive 1. 

2. Type: 

.COPY DYO:FDT.OBJ DY i : FDT . OBJiB 
.DELETE/NOQUERY DYO : FDT . OB J®) 



4.7 Installing the ReGIS Graphics Library for FEP Users (RGL/11) 

RGL/ll is the ReGIS Graphics Library software for PDP-lls. This software 
enables a user to draw figures and plots on the VT125 terminal by means of 
subroutine calls in user-created FORTRAN programs. Information about 
the capabilities of the RGL/11 software, the syntax of subroutine calls, 
example programs, and so forth, is in a single manual called the RGL/11 
Programmer's Reference Manual. 

This manual contains only the RGL/11 installation procedures. 

Installing RGL/11 involves copying the RGL/11 library and some other files 
from the distribution volume to your system disk, unless you have an RX02 
system disk, in which case RGL/11 is installed on separate floppies. The 
installation procedure is usually done in three stages: (1) you copy the 
distribution volume to a backup disk, (2) using the copy you just made, you 
run the RGL/11 installation procedure, and (3) you verify that the instal- 
lation was successful. 
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4.7.1 Background Information for Installing RGL/1 1 Files 

When you install RGL/11, you need to know how the RGL/11 programs will 
be run: overlaid or non-overlaid. The next sections give background infor- 
mation for that decision. 

4.7.1 .1 RGLyi 1 Overlays — RGL/1 1 programs can be run in one of two ways: 
overlaid or non-overlaid. An overlaid program consists of two or more pro- 
gram segments. When an overlaid program is executed, only one program 
segment is in low memory at any one time. There are two kinds of overlays: 
disk resident and extended memory resident. If the program will run under 
an SJ or FB monitor, the segments are stored on disk. If it will run under 
XM, the segments can be stored on disk or in extended memory. 

Overlays provide a way to execute a program that would otherwise exceed 
the size of memory available to you, and they are a way of trading execu- 
tion speed for program size. Using overlays, programmers can build pro- 
grams that are larger than the 32K word limit imposed by the PDP-11 
architecture. But, when overlays involve disk I/O, as they do when they are 
disk-resident, the execution speed of an overlaid program may be slower 
than it would be if not overlaid. 

One type of RGL/11 application program that usually must be overlaid 
because of size is one that calls many RGL/11 data-plotting subroutines. A 
program that calls only RGL/11 picture-drawing subroutines probably does 
not need to be overlaid. 

Information on overlays is available in Section 11.4, Creating an Overlay 
Structure, in the RT-11 System User's Guide or the PDP-11 FORTRAN 
Language Reference Manual. Information about whether to use disk- 
resident or extended-memory-resident overlays is in Sections 4.4.1.2 and 
4.4.1.3 of the RGL/11 Programmer's Reference Manual. 

4.7.1.2 RGL/11 Files — When you install RGL/11, you install the appropri- 
ate files for the scheme or schemes selected for your site: non-overlaid, 
overlaid as either disk-resident or extended-memory-resident, or overlaid 
with an alternate extended-memory overlay scheme. Table 4-2 lists the 
files for each scheme. 



Table 4-2: 


RGL/11 Files on Distribution Kit 




Section 1 

Files Needed to Run Non-Overlaid RGL/11 


Programs 


■■-' 


RGLLIB.OBJ 
GREEK.FNT 
RGLVFl.FOR 


BLODAT.OBJ 

RGLLNK.COM 

RGLVF2.F0R 




ERRTXT.TXT 
RGLLNK.COM 
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Table 4-2: RGL/11 Files on Distribution Kit (Cont.) 



Section 2 

Files Needed to Run Standard (Disk-Resident or Extended-Memory) Overlaid 

RGL/11 Programs 



PRMLIB.OBJ 

LFIXED.OBJ 

LOCATE.OBJ 

DPAPER.OBJ 

LNNICE.OBJ 

PRINUM.OBJ 

XLABEL.OBJ 

LGNICE.OBJ 

DPALIN.OBJ 

LINE.OBJ 



BLODAT.OBJ 

L0CAT2.0BJ 

PPOINT.OBJ 

LNAXIS.OBJ 

LINMIN.OBJ 

FRISTR.OBJ 

YLABEL.OBJ 

EXPTST.OBJ 

DEFALT.OBJ 

MARKER.OBJ 



ERRTXT.TXT 

LFREE.OBJ 

PDATA.OBJ 

LTAXIS.OBJ 

LINMAX.OBJ 

TEXT.OBJ 

FMINMX.OBJ 

DPALOG.OBJ 

DRWBOX.OBJ 

MOVE.OBJ 



SWINDO.OBJ 


GENOVR.OBJ 


INITGR.OBJ 


CLIPIT.OBJ 


SSTATE.OBJ 


GREEK.FNT 


RGLLNK.COM 


RGLLNK.SAV 


RGLVFl.FOR 


RGLVF2.F0R 
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Table 4-2: RGL/11 Files on Distribution Kit (Cont.) 



Section 3 

Files Needed to Run RGL/11 Programs Using the Alternate Extended-Memory 

Overlay Scheme 


REXLIB.OBJ 


BLODAT.OBJ 


ERRTXT.TXT 


LFIXED.OBJ 


L0CAT2.0BJ 


LFREE.OBJ 


LOCATE.OBJ 


PPOINT.OBJ 


PDATA.OBJ 


DPAPER.OBJ 


LNAXIS.OBJ 


LTAXIS.OBJ 


LNNICE.OBJ 


LINMIN.OBJ 


LINMAX.OBJ 


PRINUM.OBJ 


PRISTR.OBJ 


TEXT.OBJ 


XLABEL.OBJ 


YLABEL.OBJ 


FMINMX.OBJ 


LGNICE.OBJ 


EXPTST.OBJ 


DPALOG.OBJ 


DPALIN.OBJ 


DEFALT.OBJ 


DRWBOX.OBJ 


LINE.OBJ 


MARKER.OBJ 


MOVE.OBJ 


SWINDO.OBJ 


GENOVR.OBJ 


INITGR.OBJ 


CLIPIT.OBJ 


SSTATE.OBJ 


ARCOVR.OBJ 


RELOVR.OBJ 


SAVOVR.OBJ 


GN20VR.0BJ 


GREEK.FNT 


RGL0VR.COM 


RGLVFY.COM 


RGLVFl.FOR 


RGLVF2.F0R 





In each category, the first file listed is a library: 

• RGLLIB, the library you use with non-overlaid programs 

• PRMLIB, the library you use with overlaid programs, either disk- 
resident or extended-memory-resident 

• REXLIB, the library you use for the alternate extended-memory overlay 
scheme 

You can install any or all of these libraries during the same session. You 
will notice that some files are mentioned in each of the three categories. If 
you copy more than one category, only one version of a file will be copied to 
your media. 
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4.7.2 Installation of RGL/11 Software 

The procedure for installing RGL/11 varies, depending upon your distribu- 
tion media: 

• If your distribution media is a hard disk (RLOl or RL02), follow the in- 
structions in Section 4.7.2.1. 

• If your distribution media is RX02 floppy diskettes, follow the instruc- 
tions in Section 4.7.2.2. 

4.7.2.1 Hard Disk Distribution Kits — To install RGL/11, your system must 
have either 2 RLOl disk drives or 2 RL02 disk drives. Install the RGL/11 
software by following these steps: 

1. Bootstrap the system disk; these examples assume it is bootstrapped in 
drive 0. 

T5^e the following command, which prevents the monitor from display- 
ing commands in indirect command files: 

.SET TT QUIET (E) 

2. Mount the copied RGL/11 distribution disk in drive 1 and write- 
protect it. 

Assign input and output devices by typing: 

.ASSIGN DLl: IN: (Hi 

where d d 1 is the d e u i c e c o n t a i n i n 3 your 
RGL/11 distribution media 

.ASSIGN DLOs QU: m 

where ddO is the device containing -/our system disk 

3. Run the indirect command file that installs the basic RGL/11 software 
for overlaid and non-overlaid programs by typing: 

.@IN:RGLINS dD 

This command file copies RGLLIB and the files common to all three 
sections of Table 4^2 to your system disk. 

4. If you decided to execute the RGL/11 software with overlaid programs 
(either disk-resident or extended-memory-resident), run the indirect 
command file that installs the RGL/11 software related to overlays by 
typing: 

.@IN:RGLINS.DMR (fiH) 

This command file copies PRMLIB, REXLIB, and all other files in 
Sections 2 and 3 of Table 4-2. 
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5. Now you are ready to verify the RGL/11 software by following proce- 
dures described in Section 4.7.3. 

In addition to the files copied during installation, the RGL/11 distribution 
media contains RGL/11 object files and source files supplied for backup 
purposes. 

4.7.2.2 RX02 Floppy Diskette Distribution Kits — Copying the diskettes as 
described in Section 4.1.1 is all you needed to do for installation. The con- 
tents of the disks are as follows: 

1. Disk 1/5 (first of five) contains RGLLIB and all the files needed to run 
non-overlaid RGL/11 programs (see the first section of Table 4-2). 

2. Disk 2/5 contains PRMLIB and all the files needed to run standard 
overlaid (disk-resident or extended-memory-resident) RGL/11 programs 
(see Section 2 of Table 4-2). 

3. Disk 3/5 contains REXLIB and all the files needed to run RGL/11 pro- 
grams with the alternate overlay scheme, as shown in Section 3 of 
Table 4-2 and described in Section 4.3.2.3 of the RGL/11 Programmer's 
Reference Manual. 

4. Disks 4/5 and 5/5 contain RGL/11 object files and source files supplied 
for backup purposes. 

Proceed to Section 4.7.3, Verification. 

4.7.3 Verification 

When you have installed the RGL/11 software according to the directions 
given in the previous section, the software is ready for verification. Follow 
the instructions listed below for running the RGL/11 verification programs. 

Remember that RGL/11 verification must be done from a VT125 terminal. 

To verify the RGL/11 software: 

1. Be sure you have bootstrapped the system disk. These examples assume 
it is bootstrapped in drive 0. 

2. If you are using the FB or XM monitor or SJ with multi-terminal sup- 
port, type the following command, which must be in effect whenever 
you execute a program that uses RGL/11 software: 

.SET TT NOCRLF (aH 
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3. If you have an RX02 distribution kit, follow these steps (otherwise, 
continue at step 4): 

• Be sure that you have mounted in drive 1 the copied RGL/11 distribu- 
tion diskette you plan to use. If you are not planning to use overlays, 
the diskette you want is labeled 1/5 (first of the five distribution disk- 
ettes). RGLLIB and all other files from Section 1 of Table 4-2 are on 
this diskette. If you are planning to use standard overlays (either 
disk-resident or extended-memory-resident), the diskette you want is 
labeled 2/5 (the second of five). PRMLIB and all other files from 
Section 2 are on this diskette. If you are planning on using the alter- 
nate overlay scheme described in Section 4.3.2.3 of the RGL/11 
Programmer's Reference Manual, the diskette you want is labeled 3/5. 
REXLIB and all other files from Section 3 are on this diskette. 

•Type: 

.ABBIGN DYl ! DK:E) 

Go to step 5 to verify RGLLIB or PRMLIB; go to step 6 to verify 
REXLIB. 

4. If you have a hard disk distribution kit, assign your system disk to be 
your default disk. Type: 

.ASSIGN DLO: DK ! m 

where DLO is the device name and number f row which you 
bootstrapped your system 

Go to step 5 to verify RGLLIB or PRMLIB; go to step 6 to verify 
REXLIB. 

5. This step verifies RGLLIB or PRMLIB. Follow this step if you are plan- 
ning to run either non-overlaid or standard overlaid programs (disk- 
resident or extended-memory-resident). If you have an RX02 
distribution disk, you must have RGL/11 disk 1/5 or 2/5 mounted to run 
this step. Do not follow this step if you are planning to use the alternate 
overlay scheme and REXLIB. To verify REXLIB, follow step 6. 

Execute the indirect command file, RGLLNK.COM, to compile, link, 
and run the two verification programs, RGLVFl.FOR and 
RGLVF2.F0R. (Information on the RGLLNK program is available in 
Chapter 4 of the RGL/11 Programmer's Reference Manual.) Type: 

.@RGLLNK@i!l 
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When RGLLNK asks you for a program name, specify RGLVFl. 
RGLLNK also asks: 

D y u y a n t t o fri p i 1 e C Y ] ? 

Do you want 1 i s t i n 3 s [ N ] ? 

What d e 1.1 i c e do you want the listings to So to CLP:] ? 

Do you want to 1 i n K [ Y ] ? 

Do y u want a map [ N ] ? 

What device do you want the listings to So to [LP:] ? 

Do y u w ant o u e r 1 a y s [ Y ] ? 

Do y u want e x t e n d e d w e m o r y o u e r 1 a y s IHl ? 

Do y u w ant to r u n [ Y ] ? 

If you have installed the software needed to run RGL/11 programs with 
standard overlays, answer Yes to the first question about overlays. If 
you have an RX02 distribution kit and you have RGL/11 disk 2/5 
mounted, you must answer Yes to this question. (Answering Yes to the 
overlay question verifies PRMLIB.) If you have installed the software 
needed to run RGL/11 programs non-overlaid, answer No to that ques- 
tion. (Answering No verifies RGLLIB.) If you have an RX02 distribu- 
tion kit and you have RGL/11 disk 1/5 mounted, you must answer No to 
this question. 

If you are booted under the XM monitor and have installed the software 
needed to run RGL/11 programs with overlays, you can answer Yes to 
both overlay questions. (Answering Yes to both overlay questions veri- 
fies PRMLIB, but the overlays are extended-memory -resident rather 
than disk-resident.) 

While RGLVFl is running, read step 7, which describes the verification 
programs. Then execute RGLLNK.COM again, specifying RGLVF2 for 
the program name. If you have an RX02 distribution kit, before run- 
ning RGLVF2, delete RGLVFl. OBJ, RGLVFl. SAV, and VFY.TMP to 
provide enough space for the files RGLVF2 creates. 

6. Follow this step if you are planning to use the alternate overlay 
scheme. If you have an RX02 distribution kit, you must have RGL/11 
disk 3/5 mounted to run this step. To verify the REXLIB library, which 
will be used for the alternate overlay scheme, you must be booted under 
the XM monitor. Type: 

.BRGLUFY m 

When you invoke RGLVFY, it compiles, links, and runs both verifica- 
tion programs, RGLVFl. FOR and RGLVF2.F0R. 

While RGLVFl and RGLVF2 are running, read step 7, which describes 
the verification programs. At the end of RGLVFl, RGLVF2 is compiled 
and linked, so there is a pause before RGLVF2 is run. 
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7. The verification programs, RGLVFl and RGLVF2, call some subrou- 
tines from the RGL/11 library to verify that the subroutines work cor- 
rectly. The verification programs draw graphic illustrations on the 
terminal screen to demonstrate the subroutine called, display a few 
lines explaining what the subroutine does, and then wait for you to type 
<Mi before they continue. Figures 4-2 through 4-12 show the pictures 
the verification programs draw. 



Figure 4r-2: Verification Program — Screen 1 



Hit carriage return to b^in PART 1 of tte 
R^yii installation verificatiwi. 



MR-S-2200-82 
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Figure 4-3: Verification Program — Screen 2 
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Figure 4-4: Verification Program — Screen 3 



MR-S-2201-82 



Window has been reduced to lower left box 

coordinates. One box and polygon should 

renain on the screen and part of the circle, 
{hit <cr> to cont.} 




MR-S-2202-a2 
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Figure 4-5: Verification Program — Screen 4 



The locator cursor will now be displayed. 
Use the arrow keys to nove the cursor. \ 
Hove the cursor to an^ point on the display, 
and type <CR> to see the coordinates of thai 
point. 




MR-S-2203-82 



Figure 4-6: Verification Program — Screen 5 



The locator cursor will now be displayed. I 
Use the arrow keys to «ove the cursor. \ 
Hove the cursor to any point on the display. 
»id type <CR> to see the coordinates of that 
point. \ 



X= 192.000 Y= 120.000 
H .t <cr> to continue 




MR-S-2204-82 
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Figure 4-7: Verification Program — Screen 6 




Figure 4-8: Verification Program — Screen 7 



MR-S-2205-82 




MR-S-2206-82 
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Figure 4-9: Verification Program — Screen 8 



A "character set not loaded" Message 
should ^opear. Hit <cr> to continue. 

ABCDEFGHIJKLHNOPQRSTUVUXYZ 



330 ZRGL-y-NOCHARSET, character set has not been loaded 



MR-S-2207-82 



Figure 4-10: Verification Program — Screen 9 



A "character set not loaded" Message 
should appear. Hit <cr> to continue. 

AECDEFGHIJKLMNOPQRSTUVWXYZ 

fiBriEZHBIKAfUSOnrnTIX^ 



The alph^t should be printed above, 
first in English, thai in the default 
f«it, which is Greek.. Next jou should 
see this paragraph with Greek, letters. 

TIE i.fmH4 iiom ic Ki^mi Oid^e, 

Jidrxl If EhHfl, mi il illf UlUN 
Hit <cr> to cwitinue. 



MR-S-2208-82 
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Figure 4-11: Verification Program — Screen 10 



- PART 1 OF RGL/11 VI. 1 VERIFICATION ENDED 
STOP ~ 



Figure 4-12: Verification Program — Screen 11 



MR-S-2209-82 



Hit carriage return to begin P(«T2 of the 
RGL/11 installation verificati»i. 



MR-S-2210-82 
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Figure 4-13: Verification Program — Screen 12 



PDATA should have drawn a sine wave with £5 points. Autoscaling is used. 
The siaxinuM on the 3 axis is sli^htln less than 1.0. 
The winisflUhi on the h axis is slinhtln greater than -1.8. 



-100? 




Figure 4-14: Verification Program — Screen 13 



- RGL/ll VI. 1 VERIFICATION ENDED 
STW — 
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When RGLVFl finishes, it displays the message displayed in 
Figure 4-11: 

When RGLVF2 finishes, it displays the message displayed in 
Figure 4-14: 

If you receive the completion messages, the RGL/11 library is properly 
installed. 

If you do not receive the completion messages and you cannot finish the 
verification procedure, exit the verification program by typing (ctrl/c] . 
Then reset the terminal by pressing the SET-UP key and the RESET 
key (the zero key on the main keyboard). Install RGL/11 again and run 
the verification programs again from the VT125. If they again fail to 
complete, contact DIGITAL for assistance. 

8. To verify any other library that you have installed, repeat the whole 
verification procedure for that library. 

If you have an RX02 distribution kit, before you run a new verification, 
you should delete RGLVFl.OBJ, RGLVF2.0BJ, RGLVFl. SAV, 
RGLVF2.SAV, and VFY.TMP to ensure enough space on the disk for 
the files the verification procedure creates. 

4.8 Deleting the MACRO Assembler 

If you have only RX02 diskette drives and are not planning to use the 
MACRO assembler, you can delete the files MACRO.SAV and 
SYSMAC.SML from your development system diskette. Doing so will free 
disk space occupied by those files. 

NOTE 

Installation procedures for FEP/FRP components use the 
MACRO assembler. Therefore, any time you need to rebuild 
a FEP/FRP component, be sure that MACRO.SAV and 
SYSMAC.SML are on your development diskette. 

To delete the MACRO assembler, type the commands in the following 
dialog: 

• DEL HACRD.SAU .SYSMAC.SHLO 

Files deleted: 
DKsSYSHAC.SML? YdS 
DK: MACRO. SAM? YdD 
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Part III 

Using the Software 



Part III contains chapters on program development, system precautions 
and use of the RGL/11 and PLOT55 software. 



Chapter 5 

Program Development 



Once you have installed RT-11, FORTRAN IV, and the FEP/FRP compo- 
nents you need, you are ready to write your own FORTRAN programs. This 
chapter introduces you to techniques for developing programs and guides 
you to other documentation of program development techniques. 

NOTE 

All RT-11 commands in this chapter are presented in their 
simplest keyboard-command forms. To see other forms of 
these commands, consult documentation recommended in 
this chapter. 



5.1 Terminals 



Read Section 5.1.1 if you have a video terminal; read Section 5.1.2 if you 
have a hard-copy terminal. 

5.1.1 Video Terminal 

You can alter the video terminal's performance. You can set some terminal 
characteristics before using the terminal and can make other settings while 
the terminal is in use. This section describes how to make these settings. 

RT-11 requires you to set AUTO XOFF/XON. You should already have 
made this setting. (See Section 2.1.) 

If you have a VT105 terminal and plan to use PLOT55, put the terminal in 
VT52 mode before using PLOT55. (See Chapter 8.) 

When the video terminal displays a file, it displays data continuously until 
the end of the file is reached. The terminal provides two mechanisms for 
altering this continuous display. One mechanism temporarily halts the dis- 
play. The other mechanism suppresses the display. 
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To temporarily halt the display, press [ no scroll ) , which is located at the 
bottom left of the keyboard. To cause the display to resume, again press 
( NO SCROLL ] . The display resumes where it left off when you first pressed 
f NO SCROLL ] . No data has been lost. 

To suppress the display of data, type fcm/o) . To cause the display to resume, 
again type (ctrl/o) . The display resumes, but all data transmitted to the 
terminal since you first typed (ctrl/o) is lost. 

For further information, see the VT125 User's Guide or the VT105 Graphic 
Terminal User's Manual. 

5.1.2 Hard-copy Terminal 

You can alter the performance of the terminal while it is in use. When the 
terminal displays a file, it displays data continuously until the end of the 
file is reached. The terminal provides two mechanisms for altering this 
continuous display. One mechanism temporarily halts the display. The 
other mechanism suppresses the display. 

To temporarily halt the display, type (ctrl/s ) . To cause the display t o resu me, 
type (CTRL/Q) . The display resumes where it left off when you typed (ctrl/s). No 
data has been lost. 

To suppress the display of data, type (ctrl/o) . To cause the display to resume, 
again type (ctrl/o) . The display resumes, but all data transmitted to the 
terminal since you first typed [ ctrl/o ] is lost. 

For further information, see the DECLAB-11/MNC User's Guide. 



5.2 Choosing a Text Editor 



RT-ll provides two text editors, EDIT and KED, that are commonly used 
for creating and editing source programs. EDIT is designed for use with any 
terminal. KED is designed for use only with VTlOO-series terminals and 
makes efficient use of video-terminal hardware features. 

NOTE 

If you use KED with a VT105 terminal, be sure that terminal 
is not in VT52 mode (see Chapter 8). 

If you have a hard-copy terminal, use EDIT. 

If you have a video terminal, use KED, and be sure that your startup 
indirect command file contains the commands that cause the interactive 
EDIT commands to invoke KED. These commands are: 

SET TT SCOPE 
SET EDIT KED 
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5.3 Creating a Program 

To create a file for a FORTRAN program, type: 

.EDIT/CREATE pros. FOR® 

where pros is the name of your program. 

If you have a video terminal, RT-11 will execute KED. For detailed infor- 
mation on the KED editor, consult the PDP-11 Keypad Editor User's 
Guide. 

If you have a hard-copy terminal, RT-11 will execute EDIT. For detailed 
information on EDIT, consult the RT-11 System User's Guide. 

As you type your FORTRAN IV program, be sure that the program lines 
have a maximum length of 72 characters. Do so because the compiler, 
unless instructed otherwise, does not process characters beyond position 72. 
The presence of any characters beyond that position can cause the compiler 
to print confusing error messages and can cause your program to execute 
incorrectly even though it has been compiled correctly. (If you have a 
VTlOO-series terminal, you can enable the margin bell to sound when you 
reach position 72. See SETUP mode in the VT105 Graphic Terminal User's 
Manual or the VT125 User's Guide for instructions on enabling the margin 
bell.) 

Before creating a program that calls RGL/11 subprograms, read Section 
7.1, RGL/11 Files Needed for Program Development. 

5.4 Compiling a Program 

When you are satisfied that you have accurately entered your source pro- 
gram, exit from the editor and compile the program by typing: 

.FORTRAN prosEl 

where pros is the name of your program. Consult the RT-11 System 
User's Guide for more information on the interactive 
FORTRAN command. 

The FORTRAN compiler attempts to translate your source program into an 
object program (machine language instructions). If the compiler encounters 
syntax errors in your source program, it prints error messages. For help in 
understanding these messages and in removing syntax errors from your 
program, see the RT-11, RSTS/E FORTRAN IV User's Guide or the RT-11 
System Message Manual. 
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If the compiler encounters no syntax errors in your source program, the 
compiler produces an object file, prog.OBJ. Your disk then contains two 
versions of the program: 

• prog.FOR, the source program 

• prog.OBJ, the object program 

Note that the compiler only determines whether or not each statement in 
your program can be executed: the compiler finds syntax errors but does not 
find errors in program logic. Therefore, after you have written your pro- 
gram, read it carefully to be certain that when you execute the program, it 
will do what you want it to do. 

The following example contains a logic error but no syntax errors. Even 
though the compiler finds these statements free of syntax errors, the state- 
ments will produce undesirable results when they are executed: 

1 1 = 1 

GO TO 1 

2 CONTINUE 
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The linker associates your program with the subprograms that your pro- 
gram calls. These subprograms may be: 

• In SYSLIB.OBJ (the default system library) 

• In other libraries named in the linker command string 

• Individual object modules named in the linker command string 

NOTE 

Before linking programs that use the REAL-11/MNC soft- 
ware, see Section 6.5, Special Considerations in Linking 
REAL-11/MNC. If you are using the XM monitor, also see 
Section 6.6, Using REAI^ll/MNC Software under the XM 
Monitor. 

Before linking a program that calls RGL/11 software, see 
Section 7.3, Linking a Program that calls the RGL/11 
Software. 

When you have successfully compiled your program, link it by typing the 
following command string: 

.LINK pros tf ilespecsdS 

where pros is the name of your program and f i l e s p e c s are the names of 
libraries or other object files separated by commas. 
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The linker attempts to translate your object program into an executable 
load module. However, if the linker encounters inadequately defined vari- 
ables, it may not produce a load module and also prints an error message 
such as: 

?LINK-W-Undef ined Slobals 

If you encounter this error message, you probably have forgotten to include 
the names of one or more libraries or object modules in the linker command 
string. If this is the case, invoke the linker again, and be sure to include all 
necessary files in the linker command string. 

If the linker encounters no fatal errors, it produces an executable load 
module called prog.SAV. Your disk then contains three versions of your 
program: 

• prog.FOR, the source program 

• prog.OBJ, the object program 

• prog.SAV, the load module 

For further information on the linker, see the RT-11 System User's Guide. 



5.6 Using the Librarian 



The linker automatically searches SYSLIB.OBJ for variables called global 
symbols that remain unresolved after the linker has searched the files you 
have specified. For this reason you should use the librarian to add fre- 
quently used subprograms to SYSLIB.OBJ. Doing so simplifies use of the 
linker. For example, suppose your program, MYPROG.OBJ, calls subpro- 
grams contained in MNCLIB.OBJ, and MYLIB.OBJ. To link MYPROG, 
you would type: 

. LINK MYPROG ,MNCLIB tMYLIB® 

However, if you added MNCLIB and MYLIB to the default library 
SYSLIB.OBJ, you could link MYPROG by typing: 

. LINK MY PROG® 
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5.6.1 Adding Files to SYSLIB 

After you have installed all needed FEP/FRP components, you may want to 
use the librarian to add them to SYSLIB. As you do so, you must also 
remove certain global symbols from the library directory for the librarian 
to function properly. To add FEP/FRP component libraries to SYSLIB, use 
the LIBRARY keyboard command with the REMOVE option. Type: 

.LIBRARY/REHOME SYSLIB filea[,fileb,..,file2](RSl 
GLOBAL? slobalaEH 
GLOBAL? Slobalb® 



GLOBAL? slobalzES 
GLOBAL? m 

where f i l e a through f i i e z are the names of object (OBJ.) files, such as 
libraries of FEP/FRP components, that are to be added to SYSLIB 

a 1 b a 1 a through 3 1 b a 1 s are global symbols to be removed from 
the library directory 

One global symbol you must remove every time you add files to SYSLIB is 
$OVRH. You must also remove $ERRS and $ERRTB if you have added the 
FORTRAN OTS library to SYSLIB. (See Sections 3.1.4 and 3.2.4 for infor- 
mation on adding the FORTRAN OTS to SYSLIB.) If you are adding 
IBLIB.OBJ to SYSLIB, also remove the global symbol IB$ERR. If you fail 
to remove those global symbols from the SYSLIB directory, you will receive 
an error message of the following type as you attempt to add files to 
SYSLIB: 

?LIBR-W-Ille3al insert of Slobala 

where siobaiaisa global symbol that should be removed 

If you forget which global symbols to remove, create a dummy library file 
by typing a command such as the following: 

.LIBRARY/CREATE diHiUriy SYSLIBdl) 

where dummy is the name of a dummy library file 

Execution of this command will produce error messages that list global 
symbols. These are the symbols that should be removed. After creating the 
dummy library file, delete it and type the correct command for adding files 
to SYSLIB. 
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5.6.2 Using the Librarian with Two RX02 Disltette Drives 

If you have enough room on your development system diskette, you can add 
the installed FEP/FRP Laboratory Software components to SYSLIB on that 
diskette. To do so, follow instructions listed in this section. If your develop- 
ment system diskette has too little free space to accomodate an enlarged 
SYSLIB, you may want to create a single library of FEP Laboratory 
Software components on the FEP Library Diskette. To do so, follow instruc- 
tions for using the LIBRARY keyboard command in the RT-11 System 
User's Guide. 

When adding files to an existing library, such as SYSLIB, the librarian 
builds a new copy of the library that incorporates the new files, then deletes 
the old copy of the library. For this reason the disk that is to contain the 
expanded library must have enough contiguous free space available to ac- 
commodate the expanded library. When the desired output diskette has too 
little free space, you can use an extra diskette for temporary storage of the 
expanded library. One way to do so is: 

1. Place SYSLIB and all files to be added to it on the development system 
diskette. 

2. Preserve the development system diskette by following the instructions 
in Section 3.2.6. 

3. Mount a formatted, initialized diskette in DYl: 

4. Use the OBJECT option when executing the librarian. The OBJECT 
option allows you to specify an output disk on which the system will 
place the new library. For example, to add libraries of REAL-11/MNC 
and LSP files to SYSLIB on DYl:, type: 

. LIBRARY/REMDME/0BJECT:DY1 iSYSLIB SYSLIB .MNCMUL »IBLI 
GLOBAL? SlobaladSl 
GLOBAL? Global 



GLOBAL? Slobalsdl) 
GLOBAL? ® 

where s l o b a l a through s i o b a l z are global symbols to be removed 
from the library directory 

5. Create free space on drive by deleting both SYSLIB and the files you 
have added to the copy of SYSLIB that is on drive 1. Consolidate this 
free space on drive by using the SQUEEZE command. 

6. Copy the new SYSLIB from DYl: to DYO: 

.COPY DYl: SYSLIB DYO : SYSLIB® 
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5.7 Executing a Program 

When you have successfully linked your program, execute it by typing: 

.RUN pros® 

where pro 3 is the name of your program. However, before executing a 
program that calls RGL/11 subprograms, see Section 7.4, 
Running a Program that Calls RGL/11 Software. 

RT— 11 attempts to execute the load module, prog.SAV. If RT-11 encounters 
a condition that prohibits it from executing your program, RT— 11 prints a 
FORTRAN OTS (Object Time System) error message. For help in under- 
standing FORTRAN OTS error messages, see the RT-11 fiSTS/E 
FORTRAN IV User's Guide. 

When you have determined what part of your program has produced the 
error during execution, repeat all the steps listed in this chapter: 

1. Use the editor to correct the mistakes in your source program. (The 
editor changes the name of prog.FOR to prog.BAK and gives the name 
prog.FOR to the new file that contains your corrections.) 

2. Compile the source program. 

3. Link the object program. 

4. Execute the load module. 

To help find program errors, you can use the FORTRAN Debugging 
Technique (FDT). To use FDT: 

1. Compile your program and produce threaded code by typing: 

, FORTRAN/LIST p ro S/CODE : THR® 

2. Link your program and include FDT in the linker command string, for 
example: 

.LINK proSfFDTdl) 

3. Execute your program by typing: 

.RUN proadll 

See the FORTRAN Debugging Technique Reference Manual for detailed 
information on using FDT. For discussions on threaded FORTRAN object 
code, see the RT-11 User's Guide and the RT-11, RSTSIE FORTRAN IV 
User's Guide. 
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An alternate way to execute FORTRAN IV programs is to use the 
EXECUTE command in place of the FORTRAN, LINK, and RUN com- 
mands. The EXECUTE command combines the functions of those com- 
mands. To use the EXECUTE command, type: 

•EXECUTE pro3C/LINKLIBRARY:f ilespecs]® 

where pros is the name of your program. 

filespecs are the names of libraries or other object files separated 
by commas. 

5.8 Aids for Program Development 

The RT-11/FEP software includes two aids for program development. 
These aids are PREP.COM, an indirect command file, and PROGD.FOR, an 
interactive program that creates an indirect command file. Both 
PREP.COM and the indirect command file created by PROGD.FOR contain 
command lines that execute instructions useful during program 
development. 

5.8.1 Indirect Command File for Program Development 

PREP.COM is an indirect command file that serves as a model for the 
compile, assemble, link, and run phases of program development. This file 
contains a series of command lines that you can use to perform each of 
those phases. The command lines illustrate many options and capabilities 
of the FORTRAN IV compiler, MACRO assembler, and RT-11 linker. 

To create a copy ofPREP.COM that you can use for program development: 

1. If you have two RL01/RL02 disk drives, mount the copied FEP distribu- 
tion disk in drive 0. If you have only RX02 diskettes, mount the copied 
FEP Installation Diskette in drive 0. 

In drive 1, mount a system disk that contains the FORTRAN IV com- 
piler (FORTRA.SAV) and OTS (SYSLIB.OBJ— if SYSLIB includes the 
OTS— or FORLIB.OBJ— if SYSLIB does not include the OTS). 

2. Copy PREP.COM to the disk in drive 1 by typing: 

.COPY DKO: PREP. COM DK 1 : f i 1 ename . COM® 

where filename is the name of the copy of PREP.COM. (You can 
conveniently create and modify a copy of 
PREP.COM for each program you develop. By doing 
so you will have a command file that you can run 
each time you need to compile or assemble, link, 
and run one of your programs. Therefore, for 
filename use the name of the program which this 
copy ofPREP.COM works with.) 
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Remove the disk from drive 0. 

Remove the disk from drive 1, and bootstrap it in drive 0. 

3. Read the indirect command file and choose the command lines that suit 
your application. 

4. Edit the indirect command file and replace the example filenames 
(PROGl, PR0G2, PR0G3, PREFIX, and MYLIB) with the names of 
your files. 

5. Delete the exclamation point at the start of each command line that you 
want to execute. 

6. If any of the files you are referring to are on drive 1 (DKl:), use the 
editor to change the device names in those filespecs from DK: to DKl:. 

7. Read in this section discussions of the command lines you are using, 
and determine whether you need to make any additional changes. If 
any changes are required, use the editor to make them. 

To run the indirect command file, type: 

.@f i 1 en awed!) 

where f i l ename is the name of your indirect command file. 

For additional information on the RT-11 utilities, see the RT-11 help files 
or documentation. To see RT-11 help files on the FORTRAN IV compiler, 
the MACRO-11 assembler, the RT-11 linker, and the RT-11 RUN com- 
mands, type: 

.HELP topic® 

where topic is Fortran, macro, link, run, or frun 

For additional documentation, see the RT-11 fiSTSIE FORTRAN IV 
User's Guide, the PDP-11 MACRO-11 Language Reference Manual, and 
the RT-11 System User's Guide. 

The remainder of this section lists each command line in PREP.COM and 
describes the results of executing that line: 

! FORTRAN/ LI ST/WARN I NGS/ONDEBUG/DBJECT:DK: DK: PROGl 

The FORTRAN IV compiler creates the object file PROGl.OBJ and stores it 
on drive DK:. The compiler includes debug lines (those lines in the source 
file with a D in column one) in the compilation. The compiler also prints a 
listing on the line printer and includes warnings among the FORTRAN IV 
diagnostic error messages. 

! FORTRAN/WARN INGS/OBJECTuDK DK : PROG 1 /LIST : DK : 

The FORTRAN IV compiler creates the files, PROGl.OBJ and 
PROGl. LST, and stores them on drive DK:. The compiler also includes 
warnings among the FORTRAN IV diagnostic error messages. 
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! FORTRAN/LI ST !DKs/ ALLOCATE uNN. /OB JECT:DK: DK : PROGl+DK : PR0G2 

The compiler integrates the source files, PROGl and PR0G2, into a single 
object file, PROGl.OBJ. The compiler stores this object file on drive DK: 
and creates the listing file PROGl. LST, which is stored in the allocated 
space on drive DK:. (See the discussion of compiler options in the 
RT-llJiSTS/E FORTRAN IV User's Guide for help in choosing a value for 
NN. Use the editor to change nn to that value.) 

iFORTRAN/LIST/HEADER/NDLINENUMBERS/OBJECTsDK: 
DK: PROGl .DK ; PR0G2 »DK : PRDG3 

FORTRAN IV creates three object files — PROGl.OBJ, PR0G2.0BJ, and 
PROGS. OBJ — and stores them on drive DK:. the compiler also produces a 
listing of each file on the line printer. Each listing names the compiler 
options currently in effect but does not include sequence numbers. 

IFORTRAN/LISTiDKs DK ! PROGl+DK s PR0G2/ OBJECT : OK : 

The FORTRAN IV compiler integrates the source files, PROGl.FOR and 
PR0G2.F0R into a single object file, PR0G2.0BJ. The compiler also cre- 
ates the listing file PROGl .LST and stores the object and listing files on 
drive DK:. 

!MACRD/LIST/CR0SSREFERENCE:S/0BJECT:DK:DK!PR0G1 .DK s MYL IB/L IBRARY 

MACRO-11 assembles the source file PROGl.MAC and uses the library 
MYLIB.MAC to satisfy references made with the .MCALL directive. 
MACRO-11 stores the object file on drive DK: and sends to the lineprinter 
a listing that includes a cross-reference of user-defined symbols. 

! MACRO /EN ABLE :LSB:GBL DK s PROGl+DK s PR0G2/ OB JECT ! DK s 

The MACRO-11 assembler creates PR0G2.0BJ as an assembly of both 
PROGl.MAC and PR0G2.MAC. During the process, MACRO-11 enables a 
local symbol block and treats all undefined symbol references as default 
global references. 

! MACRO DK s PREFIX/PASS : 1+DK : PR0G2/LIST : DK : /NOSHOW:BEX 

The MACRO-11 assembler creates PR0G2.0BJ from the source file 
PR0G2.MAC. During the first pass of the assembly, MACRO-11 processes 
PREFIX.MAC, a prefix file that contains macro definitions. The assembler 
also creates a listing file, PR0G2.LST, on drive DK: and suppresses the 
binary extensions. 

! LINK /MAP /DEBUG /EXECUTE :DK! DKs PROGl 

The RT-11 linker creates the executable load module, PROGl. SAV, by 
linking the object file, PROGl.OBJ, with ODT, the On-line Debugging 
Technique. The linker stores PROGl. SAV on drive DK: and creates a load 
map listing that is printed on the lineprinter. (For more information on 
ODT, see the RT-11 System User's Guide.) 

ILINK/MAPsDKs/EXECUTEnDK: DKsPROGl .DK : PR0G2 >DK s PR0G3 

The linker creates the executable load module, PROGl. SAV, by linking 
PROGl.OBJ, PR0G2.0BJ, and PR0G3.0BJ. The linker also creates 
PROGl.MAP, a load-map listing file, and stores both PROGl.MAP and 
PROGl. SAV on drive DK:. 
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! LINK /MAP/ FOREGROUND !Z5B. /EXECUTE :DK DKsPROGl 

The RT-11 linker creates file PROGl.REL, which can be executed as a 
foreground job under either the FB or XM monitor. The linker allocates 256 
(decimal) bytes of stack space for the job. The linker also sends a load-map 
listing to the lineprinter. 

!LINK/MAP:DK! DK ! PROGl *DK s PR0G2/EKECUTE : DK s 

The linker creates the executable load module, PR0G2.SAV, by linking 
PROGl.OBJ and PR0G2.0BJ. The linker also creates PROGl.MAP, a 
load-map listing file, on drive DK:. 

! LINK/EXECUTE :DK ! /RUN DK t PROGl ,DK : PR0G2 .DK : PR0G3 

The linker creates the executable load module, PROGl.SAV, by linking 
PROGl.OBJ, PR0G2.0BJ, and PROGS. OBJ. The linker also initiates ex:e- 
cution of PROGl.SAV as a background job. 

!RUN DK:PR0G1 

This RUN command loads PROGl.SAV into memory and executes it as a 
background job. 

IFRUN DK: PROGl /BUFFER:!-, 

This command executes PROGl.REL as a foreground job and reserves more 
memory space than the program size. The /BUFFER option must be used to 
run a FORTRAN IV program as a foreground job. Use the following for- 
mula to determine the size of ri , an octal value that specifies the number of 
words of memory to be allocated to PROGl.REL: 

n = [1/2 [504 + (33*c) + (r-136) + (a*512)]] 

where a is the number of files open at one time. (If double buffering is in 
effect, multiply the number of files by 2.) 

c is the number of channels (logical unit numbers). 

r is the maximum record length. (The default is 136 characters.) 

IFRUN DK:PR0G1/PAUSE 

This command loads PROGl.REL as a foreground job, prints the load ad- 
dress, and delays execution until the RESUME command is issued. During 
the pause, you may enter ODT commands to help debug PROGl. Note that 
should PROGl be a FORTRAN IV program, you must specify the 
/BUFFERin option. 

IFRUN DK:PROGl/TERHINAL:tii 

This command assigns a particular terminal to interact with the fore- 
ground job. Use the editor to change m to the logical unit number of the 
terminal you have chosen. Note that if PROGl is a FORTRAN IV program, 
you must specify the /BUFFER:n option. 
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5.8.2 Interactive Procedure for Program Development 

PROGD is an interactive program that creates an indirect command file 
that is useful during program development. PROGD asks you questions 
and displays valid answers in brackets (C ]). Any time you are not sure how 
to answer a question, type HELP® or H®, which causes PROGD to dis- 
play additional information about valid responses. 

Install PROGD by executing the following procedure: 

1. In drive 0, mount a system disk that contains the FORTRAN IV com- 
piler and OTS. 

If you have two RL01/RL02 disk drives, mount the copied FEP distribu- 
tion disk in drive 1. If you have only RX02 diskettes, mount the copied 
FEP Installation Diskette in drive 1. 

2. Copy PROGD to the disk in drive by typing: 

.COPY DKl: PROGD. FOR DKO : PROGD . FOR® 

3. Remove the disk from drive 1. 
Run PROGD by typing: 

.RUN PROGDdl) 

The following sample PROGD dialog contains answers that elicit all intro- 
ductory and help messages: 

.RUN PROGDdS 

Do you want introductory Messages [Y/N]?Y@1B 

PROGD is an i n t e rac t i u e prosram that creates indirect command files 
that help you deuelop prodraitis. After creatin3 one or more source 
files* in either FORTRAN or MACRO » you can use PROGD to assist you 
in the next three phases of proSram dey e 1 opmen t . These phases are: 

• COMPILING OR ASSEMBLING 

• LINKING 

• RUNNING 



Type (BS to continue.® 

PROGD asks you for the names of files you would liKe to compile or 
assemble* link* and run. (As you enter each filename* enter the 
filetype if the filetype is not the default.) PROGD also asKs you 
for compiler* assembler* and linker options. 
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PRDGD repeatedly asKs you to enter filenames and options. To 
tell the prosraw that you ha ye entered all desired responses to a 
filename or option prompt* press only ®) in response 
to that prompt. To obtain a list of acceptable responses to 
a prompt* type HELP orH in answer to that prompt. To abort 
the program t type^k/S in response to any prompt. TypinsfEEl in re- 
sponse to any question that lists Y and N as ualid answers is the 
same as tvpins NO. 

PROGD constructs command lines that are stored in an indirect com- 
mand file. When you execute the indirect command file> it compiles 
or assembles* linKs* and runs the files you have named during the 
interactiue phase of the proflram. Note that although this indirect 
command file can 1 i n K two or more object f i 1 e s t it can produce only 
one executable load module. 

(dB to continue XES) 

Indicate the device on which your files for 
program development reside. 

1, SY: 

2, DLO: 

3, DLl: 
a, DYO: 
5 . DY 1 : 

[1/2/3/4/5] : 3® 

FORTRAN compilation* MACRO assembly* or LINKAGE7CF/M/L]? J® 

The only valid responses are " F " * " M " > or " L " . 

FORTRAN compilation* MACRO assembly* or LINKAGE? ITF/M/L]? F® 

*«#* FORTRAN COMPILATION PHASE *»** 

Files V\m 

• Normally* PROGD causes a separate object file to be 
created for each source f i 1 e ■ y o u specify. H o w e u e r > you 
can specify source filenames in such a way that a s i n 3 1 e 
object file is created for two or more source files. To 
cause this to happen* specify source files as a strins of 
filenames separated b x plus s i 3 n s . 

• You can enter one filename or Sroup of filenames per line. 
You can also enter two or more filenames or Sroups of 

f i I e n a rii e s on the same line by entering them as a s t r i n 3 
of filenames or 3 r o u p s of filenames separated by commas. 

• Include compiler options that affect the file or sroup 
of precedin3 files separated by plus sisns. 

• The FORTRAN default input file type is .FOR* the MACRO 
default input file type is .MAC* and the default output file 
type is .OBJ for both the compiler and assembler. 

Do you also want a listins of options? [Y/N] Ydgl 

*#*» FORTRAN OPTIONS *#*» 

/ALLOCATEssize 

Reserves space for an output file 
/CODE: type 

Specifies the type of machine code to be Senerated 
/DIAGNOSE 

Expands compiler crash dump information 
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/EXTEND 

Enables SO-columri source input 
/HEADER 

Includes the "options-in -effect" header in the listinS 

file 

Allocates 4 bytes for sin3le-precision inteSers 
/LINENUNBERS (default) 

Includes internal sequence numbers in compiled prosrams 
/LISTCif ilespec] 

Produces a listing file 
/NOLINENUMBERS 

Supresses internal sequence numbers in compiled programs 
/NOOBJECT 

Suppresses output of the binary object file 

Type (bEI to c o n t i n u e (ret) 
/NODPTIMIZE[:type] 

Disables a specific optimization 
/NOSWAP 

Causes a compiled program to Keep the USR resident durinS 

execution 
/NOUECTORS 

Specifies array access by multiplication operations 
/NOWARNINGS 

Supresses warnins messasfes durinS compilation 
/OBJECTC:f ilespecl 

Specifies a file name for the object file 
/ONDEBUG 

Includes D lines in compilation 
/OPTIMIZEC : type] 

Enables a specific optimization 
/RECORD: lenSth 

Alters the default record length for sequential ASCII 

formatted I/D 
/SHOW:value 

Controls the listins content 
/STATISTICS 

Includes compilation statistics in the listing file 

Type (HB to continue) " R " to re-read. (Bg) 
/SWAP (default) 

Causes a compiled program to swap the USR durins execution 
/UNITS:n 

Specifies the number of losical units that can be open at 

once 
/VECTORS (default) 

Specifies array access by tabular looKup 
/WARNINGS 

Includes warn ins messages in the listing file 



Type SS to continue* " R " to r e - r e a d gg) 
Files TEMPie) 
File; TEMP2 ,TEMP3Eil) 
File; (ggl 
Options HdD 

OPTION ENTRY; 

• Multiple options may be entered singly or as a string. 

• Enter options that qualify the entire command strinS. 
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Do you also want a lislinS of the options? [Y/N] NO 
Option ! /WAEh) 
Option: /LISUl) 
Option :(aED 

Y our Com in and: 

FORT/WA/LIS 

Files? DLl : TEMPI tDLl :TEMP2 .DLl :TEMP3 

Any Corrections EY/Nl? M®) 

The only valid responses are YES [Yl* or NO INl , 

Any Corrections C Y/N]? (513 

Another cowpilation /assembly [Y/Nl? Y<M) 

FORTRAN compilation » MACRO assembly » or LINKAGE? CF/M/Ll? MdD 

**** MACRO ASSEMBLY PHASE #*#* 

File: TEMPa+TEMPSdB 

File:® 

Option : HELPEll) 



OPTION ENTRY: 

• Multiple options may be entered singly or as a strin^t 

• Enter options that qualify the entire command strins. 



Do you also want a listing of the options? EY/N] Yl®) 



##*# MACRO OPTIONS **#* 

/ALLOCATE:size 

Reserves space for an output file 
/CROSSREFERENCEC :typeC. . . :type]] 

Generates a cross-reference table in the listing file 
/DISABLE: ual ueC ,..: value] 

Specifies a .DSABL directive 
/ENABLE: valueC , . . : value] 

Specifies an .ENABL directive 
/LIBRARY 

Identifies a file as a macro library file 
/LISTC :f ilespec] 

Produces a listinS file 
/NOOBJECT 

Sup r esses output of the binary object file 
/NOSHOW: value 

Specifies an .NLIST directive 

Type ® to continue.® 
/OBJECTC :f ilespec] 

Specifies a file name for the object file 
/PASS:1 

Specifies a file as a prefix macro or conditional file 
/SHOW : value 

Specifies a .LIST directive 



Type d!) to continuet "R" to re-read.® 
Option : /ENA:GBL(1!) 
Option: /SH:MEB(l!l 
Option;® 
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You r Command ; 

MAC/ENA:GBL/SH:MEB 

Files? DLl :TEMP4 + DL1 :TEHP5 

Any corrections [Y/N]?® 

Another compilation /assembly [Y/N]?® 

**** LINKAGE PHASE #*#* 

Are you linKinS to REAL-11/HNC [Y/Nl? YdD 

In response to the Option: prompt be sure to 
include the f o 1 1 o w i n 3 » where d y n : is the d e u i c e on 
which the REAL-11 library exists and filespec is the 
name of the REAL-11/MNC library you are usinS. 

/LIBsdunsfilespec 

File: TEMP 1 »TEMP2 »TEMP3(ll) 
File: TEMPa® 
File: HELP® 

• Input filenames sin Sly or as a strinS 
of nawes separated by commas. 

• The LINKER default input filetype is .OBJt and the 
default output filetype is .SAV for bacKSround Jobs» 
and 4REL for foreground Jobs. 

• Include linker options that affect each file. 

• To bypass the linkage and run phases t press (E) 
in response to the first prompt for a filename. 

Do you also want a listinS of options? EY/N] Y® 



**** LINKER OPTIONS #*** 

/ALLOCATEssise 

Reserves space for an output file 
/ALPHABETIZE 

Lists Slobal symbols on the link map in alphabetical order 
/BITMAP (default) 

Outputs the program bit map 
/BOTTOMsn 

Specifies the lowest address to be used by the linked program 
/BOUNDARYsualue 

Starts a specific program section on a particular 

address boundary 
/DEBUGCsf ilespeo] 

Links ODT or the debuSSin? prosram you specify with your 

p r a r a m 
/EXECUTEC :f ilespecl 

Specifies the name of the memory imase file 
/EXTEND:n 

Extends a proSram section to the size you specify 
/FILLsn 

Initializes unused locations in the memory imaSe file 

to the u a 1 u e you specify 

Type El to continue.® 
/F0REGR0UNDC:stacksizel3 

Links the proSram for foreground execution 
/INCLUDE 

Accepts specific Slobal symbols by name for 

inclusion in the memory i m a S e file 
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/LDA 

Produces a file in absolute binary loader format 
/LINKLIBRARL :f ilespeo] 

Includes the file you specify as a library in the 1 i n K 

OPe ration 
/MAPC : f i lespec] 

Generates a load map 
/NOBITMAP 

Does not output the proSram bit Map if there is 

code below location 400 
/NOEKECUTE 

Su presses creation of the Memory imaSe file 
/PROMPT 

Indicates that there is more than one line of input to the linker 
/ROUNDsn 

Rounds UP a specific proSram section so that the root is a 

multiple of the u a 1 u e you specify 

Type (HD to continue) " R " to r e - r e a d . (M) 
/RUN 

Initiates execution of the linked pros ram 
/SLOWLY 

Uses the larSest possible area for the symbol table during the 

linK operation 
/STACK Csn] 

Specifies the stack address for the linked program 
/SYMBOLTABLEC :f ilespec] 

Generates a symbol table file 
/TOPsn 

Specifies the highest address to be used by the linked proSram 
/ TRANSFER [ :n] 

Specifies the starting address of the linked program 
/WIDE 

Produces a load map that is 132 columns wide 
/KM 

Specifies that a Job to be run under the KM monitor requires the 

SPeoialSETTOPfeatures 



Type El to continue* "R" to re-read. @) 

File: E) 

Option: /L IB : DLO : MNCL I B/MAP : DL 1 :© 

Option:® 

Y our Co m itt and: 

L IN/LIB: DLO: MNCL I B/MAP :DL1: 

Files? DL1:TEMP1 »DL1:TEMPZ ,DL 1 : TEMP3 ,DL 1 : TEMP4 

Any Corrections CY/N]?® 

*#** RUN PHASE **#* 

R CR3 
RUN CU] 
FRUN CF] 
NEITHER CN] 
CR/U/F/Nl? HdH 

The R command loads a memory imase file from 

the system d e u i c e into memory and starts execution. 

Note the only valid deuice is BY:. There are 

no options af fee tins this command. 
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Use the R c o m m a n d for: 

• aback Ground Job 

• a background p r i y i 1 e Sed Job under KM 

• a background virtual Job under KM 

The RUN command loads and starts a proSraw that has 
the filetype .SAU and resides on any RT-11 block- 
replaceable deuice» Any argument or input and output 
list you include is passed to the program in Command 
StrinS Interpreter format, 

Use the RUN command for: 

• a background Job 

• a background priuileSed Job under KM 

Type Ml to continue.® 

The FRUN command loads and starts execution of a 
foreground program with the filetype .REL. Only one 
foreground program can be run at a time. 

*#** FRUN OPTIONS **** 

/BUFFER :n 

Reserues n words in memory OMer and aboye normal proSram size 
/NAME : jobname 

AssiSns the specified losical Job name to the Job! 

system Job monitors only 
/PAUSE 

Prints the load address and yaitsi a RESUME command will start the 

Job 
/TERMINALsn 

Assigns terminal unit n to interact with the foreground 

Job! multi-terminal monitors only 



Type dB to continue* "R" to re- re ad. (ID 

***# RUN PHASE **«* 

R CR] 

RUN CU3 

FRUN [N] 

NEITHER [N] 

[R/U/F/N]? Rm 

Your commands are filed under the name 

**** TEMPI .COM *#** 

To wiew. type: TYP TEMP1.COM 
To execute* types iTEMPl.COM 



STOP - - END 

.TYP TEMPI .COMEH) 

FORT/WA/LIS 

DLl : TEMPI .DLl : TEMP2 .DLl : TEMP3 

MAC/ENAsGBL/SH:MEB 

DLl :TEMP4+DL1 :TEMP5 

L IN/LIB !DLO:MNCLIB/MAP: DLl: 

DLl: TEMPI ,DL1:TEMP2 .DLl : TEMP3 .DL 1 : TEMP4 

R TEMPI 
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Chapter 6 

System Precautions for Users of REAL-11/MNC 



When using the REAL-11/MNC software, you should be famihar with cer- 
tain features of RT-11 and recognize some limitations on its use with that 
software. This chapter describes these features and limitations. 



6.1 Special Keys: (cm/cl and ( break ) 

The effect of typing (ctrl/c) while a FORTRAN IV program is running de- 
pends on which RT-11 monitor you are using: the FB monitor or the SJ 
monitor. 

When you are using the RT-11 SJ monitor, typing (ctrl/c) causes a QBUS 
INIT function to occur. This RT-11 function clears and initializes all de- 
vices on the system. The SJ monitor executes a QBUS INIT reset when a 
program terminates. See the RT-11 documentation for details. 

When you are using the RT-11 FB monitor, typing jctrl/c) causes the moni- 
tor to clear all the Control and Status Registers (CSRs) related to 
MNC-series modules for the job interrupted by the (ctrl/c) . Typing (ctrl/c) 
while using the FB monitor does not cause a QBUS INIT function to occur. 
If QBUS INIT were to execute while another job is running, it could in- 
terfere with the successful running of that other job. 

Another special key is ( break ) . As discussed in Chapter 2, you can type 
( BREAK ] whenever you want to halt the processor. When you type 
( BREAK ) , the processor halts, the terminal displays a six-digit octal num- 
ber, and all system activity ceases. Since system activity ceases, any data 
being transmitted after the CPU has halted is lost. If you have t3q)ed 
( BREAK ) accidentally, you can restart the processor immediately by typing 
P. If you were using KED when you typed [ break ) and some unwanted 
characters have appeared on your terminal, you can remove those charac- 
ters by typing (ctrl/w) . 
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6.2 Completion Routines 



Completion routines are user-written, FORTRAN-callable subprograms 
that usually execute asynchronously with a main subprogram (that is, 
when the main program has been interrupted). This section describes com- 
pletion routines only as they are used with asynchronous sweeps. (Burst- 
mode sweeps also use completion routines but execute them sequentially 
rather than asynchronously. For information on differences between asyn- 
chronous and burst-mode sweeps, see the REAL—11/MNC Programmer's 
Reference Manual.) Completion routines are handled differently by the SJ 
and FB monitors. If you plan to write completion routines in your pro- 
grams, you should be familiar with these differences. 

Under the SJ monitor, completion routines can interrupt one another. If no 
other completion routine is executing when a completion routine is called, 
the SJ monitor executes the requested completion routine immediately. If a 
completion routine is executing when another is called, the second comple- 
tion routine interrupts the first, executes, then returns control to the first. 

The SYNCH ERROR code is not detected under the RT-11 SJ monitor. 
(With the REAI^ll/MNC software, the SYNCH ERROR code is returned 
as status-code 337 in the sweep-status word; see the REAL-lllMNC 
FORTRAN Programmer's Reference Manual for more information on the 
sweep-status word.) Therefore, a completion routine is not prevented from 
interrupting itself. This situation is almost always fatal. In general, you 
should use great care if completion routines are used in your program and 
your program is running under the SJ monitor. 

Under the FB monitor, completion routines cannot interrupt one another. 
Consequently, if a completion routine is executing when a second one is 
called, the first completion routine continues to execute until finished, re- 
gardless of whether it was called from a main program operating in the 
foreground or background of memory. After the first completion routine has 
finished its work, the second completion routine executes, followed by the 
main program. 

With two or more completion routines active, along with main programs 
requiring the foreground and background, the FB monitor schedules the 
completion routines and main programs according to the priorities listed 
below. 

Highest Priority Interrupt Service Routines (priority determined by the 
hardware) 

RT-11 FB monitor 

Foreground completion routines 

Background completion routines 

Foreground main programs 

Background main programs 
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Lowest Priority Null job 

As the list shows, completion routines, whether running in the foreground 
or background, have priority over all main programs. Foreground comple- 
tion routines have priority over background completion routines, and fore- 
ground main programs have priority over background main programs. 

Though one completion routine cannot interrupt another completion rou- 
tine when running under the FB monitor, a completion routine can inter- 
rupt a main program in order to execute. 

For additional information on completion routines, see the RE AL-11/MNC 
FORTRAN Programmer's Reference Manual. 
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You can use FORTRAN IV virtual arrays with the REAL-ll/MNC soft- 
ware. However, you cannot use virtual arrays as REAL-ll/MNC buffers or 
subprogram arguments. 

To use virtual arrays, you must have an 11/23 processor and more than 32k 
words of memory. You must also have installed the FORTRAN IV OTS to 
support virtual arrays under the SJ, FB, or XM monitor. (See discussions of 
the OTSGEN dialog in Sections 3.1.4 and 3.2.4.) 

If you are using virtual arrays with the SJ or FB monitor, you must install 
the patch that causes the monitor to bootstrap into 28k words, instead of 
30k words. Instructions for installing this patch are listed in the RT-11 
Installation and System Generation Guide, Section 2.8.19, Running RT-11 
in Less Memory Than is Available. As you follow those instructions, install 
the following patch instead of the one listed in the RT-11 Installation and 
System Generation Guide: 



, R SIP 
*monitr.SY 
Base? lOOOdB 
Offset? 30®) 

Base Offset Old 

001000 000030 000407 

001000 000032 013704 

001000 000034 177570 

001000 00003B 042704 



* (CTRL/c ) 

.COPY/BOOT dyOiitionit r.SYS duO: 



New? 

000240(111) 
012704® 
1577 7BB) 

ICTRL/v ) (RETl 



where 



moni t r 



du 



is RT 1 IS J if you are installing a patch to the SJ monitor or 
RTl IFB if you are installing a patch to the FB monitor 

is DL if you have two RL01/RL02 disk drives or dy if you 
have only RX02 diskette drives 
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6.4 INTSET and .PROTECT 

There are two RT-11 facilities that you should not use to access the 
MNC-series modules when you are simultaneously using the 
REAL-11/MNC software. These facilities are the FORTRAN IV Interrupt 
Service Routine (ISR) called INTSET and the programmed request called 
.PROTECT. 

You can, however, use these facilities to access hardware devices other than 
the MNC-series modules. (For more information on INTSET and 
.PROTECT see the RT-11 documentation.) 

6.5 Special Considerations in Linlcing REAL-H/IVINC Software 

This section lists some considerations you should be aware of when linking 
REAL-11/MNC subprograms with your calling FORTRAN IV program. 
Section 6.5.1 contains information on linking REAL-11/MNC software 
under any RT-11 monitor. Section 6.5.2 contains information on linking 
REAI^ll/MNC software under the RT-11 SJ and FB monitors. For addi- 
tional considerations involving the linking of REAL-11/MNC software 
under the XM monitor, see Section 6.6, Using REAI^ll/MNC Software 
under the XM Monitor. 

6.5.1 Linking REAL-II/IVINC Software under any RT-11 Monitor 

You can place REAL^ll/MNC subprograms in either the root segment of 
your FORTRAN IV program or in a disk overlay segment. 

If you place REAL^ll/MNC subprograms in a disk overlay segment, you 
must observe the restrictions for creating virtual overlays that are listed in 
Section 6.6.4. You can also use the sample procedure described in that 
section. However, as you link the program, use the /0:n (overlay) option 
instead of the /V:n option. Use the /Q option mentioned in Section 6.6.4 only 
if you are using the XM monitor, 

6.5.2 Linlcing REAL-11/MNC Software under RT-11 SJ 
or RT-11 FB 

This section contains information pertinent to users of the RT-11 SJ and 
FB monitors. For information on linking programs under the RT-11 XM 
monitor, see Section 6.6, Using REALr-11/MNC Software Under the XM 
Monitor. 

Several I/O operations, such as the opening and closing of files, require the 
use of RT-11 User Service Routines (USRs). The USR portion of the RT-11 
SJ and FB monitors is not permanently resident in memory. Usually the 
USR is swapped over a defined section of memory whenever a program 
requires any of its services (for example, during a sweep operation). 
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However, an untimely swapping of the USR can cause a fatal system error. 
You can avoid such an error by locking the USR into memory before run- 
ning a program that requires its services. The following command locks the 
USR into memory: 

SET USR NOSWAP® 

If you cannot lock the USR into memory (if to do so, for example, requires 
too much memory), and you want to avoid the fatal system error, you must 
identify certain areas of memory that the USR must not swap over. You 
can then direct the USR to other areas of memory that do not involve the 
risk of a fatal error. 

You can identify the areas of memory that the USR must not swap over by 
looking at a link map, which gives the addresses of these areas. Such areas 
include the sections containing completion routines. 

For further details regarding the swapping algorithm and areas of memory 
affected by swapping the USR, see the RT-11 Software Support Manual 
and the RT-11, RSTS/E FORTRAN IV User's Guide. 

6.6 Using REAL-11/MNC Software under the XM Monitor 

The RT-11 Monitor offers special features to support extended memory. 
These features are only occasionally useful for REAL-11/MNC applica- 
tions. Therefore, DIGITAL recommends using the RT-11 SJ or FB monitor 
with the REAL^ll/MNC software. However, as long as you use the proce- 
dures listed in this section, you can use the XM monitor with 
REAL-11/MNC. Also, note that to use the XM monitor, you must have an 
11/23 processor and should have at least 64k words of memory. 

For a detailed discussion of extended memory, see Chapter 4 of the RT-11 
Software Support Manual. 

6.6.1 Privileged and Virtual Jobs 

Under the XM monitor, jobs may be either privileged or virtual. The terms 
"privileged" and "virtual" refer to the way in which physical memory is 
allocated to a job and to that job's rights to access other memory areas, such 
as the buffers and hardware registers for the MNC-series modules. 

Unless you specify otherwise, all jobs under the XM monitor are privileged. 
Furthermore, any jobs that use REAL-11/MNC data-transfer subprograms 
must be privileged. However, a job that uses only computational routines 
(for example, the REAL-ll/MNC subprogram FLT16), can be run as a 
virtual job. To use any procedures described in this section, you must run 
jobs as privileged. 
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6.6.2 Linking Bacl(ground Jobs under XM 

To link a background job that uses the REAL-11/MNC software under the 
XM monitor, type: 

. R LINK® 

# proSC »map] = proS treallib/ OESI 

Load section sad dress? aaaaa : riririnri® 

Load section : add ress?® 

where pros is the name of your program 

map is the name of the output map file, which is optional 

real lib is MNCSNG, MNCMUL, or MNCLIB — the name of the 
REAL-11/MNC library that you are using 

aaaaa is*C0DE if prog uses completion routines and *data if 

prog does not use completion routines 

n n n n n is B if your system uses the MQ handler and 40000 

if your system does not use the MQ handler 

This link procedure may produce one of the following warning messages, 
which should be ignored: 

?LINK-W-load address too low PSECT $DATA 
?LINK-W-load address too low PSECT $CODE 

NOTE 

Only advanced users should attempt the following additional 
procedures. 

If the link procedure did not produce the error message indicating that the 
load address is too low (as listed above), you may be able to link your 
program to use memory more efficiently. To do so: 

1. Link your program again by using the procedure listed earlier in this 
section, but do not use the /Q option. This procedure produces a 
load map. 

2. Study the load map and determine whether any of the .KSCT p-sects 
can be moved to the area of memory between p-sect SYS$S and octal 
address 20000. (The area of memory between octal addresses 20000 and 
37777 is a restricted area for PARI.) 

3. If you can move one or more .KSCT p-sects, generate a dummy file with 
only p-sect directives in the new sequence. Be sure that the attributes 
are identical to the original and that you include all p-sects listed in the 
load map produced in step 1. 

4. Assemble the dummy file. 
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5. Link again. As you do so, specify the dummy file first. Then link again 
as you normally would for the XM monitor and include the /Q option. If 
your program uses completion routines or the MQ handler, make suit- 
able adjustments. 

6.6.3 Linking and Executing Foreground Jobs under XIV! 

To link and execute a foreground program that uses the REAL-11/MNC 
software under the XM monitor, use the following procedures: 

1. When linking your program, use the /FOREGROUND and /LIBRARY 
options. For information on these options, see the discussion of the 
LINK keyboard command in the RT-11 System User^s Guide. Type: 

.LINK/F0R:256.C/MAP:DK!]/L IBs real lib pros® 

where r e a li i b is MNCSNG, MNCMUL, or MNCLIB — the name of 
the REAL-11/MNC library that you are using. 

pros is the name of your program. 

2. To execute your program, use the FRUN keyboard command with the 
/PAUSE and /BUFFER options. The FRUN command with the /PAUSE 
option loads a program and prints the load address before the program 
is executed. The /BUFFER option allows you to specify additional pro- 
gram workspace required for internal buffers. Type: 

.FRUN pro 3/ PAUSE/BUFFER unrindU 

where pros is the name of your program. 

nnii is an octal number that specifies the number of words of 
memory reserved for your program. (For information on 
how to choose a value for rmn, see the discussion of the 
FRUN keyboard command in the RT-11 System User's 
Guide.) 

RT-11 responds with a message that tells whether your program was 
loaded into memory. 

If the following message appears, your program was loaded, and you 
can proceed to step 3 of this procedure. 

Loaded at nnnnn 

where nnnnri is the load address 

If the following message appears, RT— 11 has failed to load your 
program: 

?KMON-F-Not enoLiSh Memory 
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If that message has appeared, use the SHOW DEVICES and SHOW 
JOBS keyboard commands to determine which device drivers and pro- 
grams are loaded in memory. If you do not need some of the device 
handlers and jobs displayed, use the UNLOAD keyboard command to 
remove them, and retype the FRUN command line to execute your job. 
If there still is too little memory for your job, it is too big to run as a 
foreground job under the XM monitor. If that is the case, you may be 
able to rearrange your program to run in overlays, or you may be able 
to run the program under the FB monitor (after relinking it). 

For more information on the FRUN, SHOW, and UNLOAD keyboard 
commands, see the RT-11 System User's Guide. 

3. If your program is in memory and RT-11 has printed a load address, 
determine if the program was loaded in a portion of memory where it 
can be executed: 

If the load address is at least 42000 (octal), you should be able to exe- 
cute the program. 

If you are using the MQ handler, you probably cannot execute your 
program unless the load address is at least 62000 (octal). 

For information on the mapping problems that make some areas of 
memory unavailable for program execution, see the section entitled 
"Interrupt Service Routines in XM Systems" in the RT-11 Software 
Support Manual. 

4. If your program is in an area of memory where it can be executed, type: 

.resume: pros]® 

where pros is the name of your program. You must specify a value 
for prog if system-job support is enabled on your monitor. 

The RESUME command causes your program to be executed. (The 
/PAUSE option used with the FRUN command suspended execution.) 

If you have specified too small a buffer value for nnn in the FRUN 
command line, RT-11 displays a message such as one of the following: 

?ERRG2Fortrari start fail 
?ERR Ot non-Fortran error call 

If one of those messages appears, retype the FRUN command and use a 
larger value for nnn. 

For information on system-job support, see the RT-11 Installation and 
System Generation Guide. For more information on the RESUME key- 
board command, see the RT-11 System User's Guide. 

5. If you are using the console terminal as a shared console for foreground 
and background jobs, press (ctrl/ f ] prior to entering any data that the job 
requests. 
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6. When your job has completed, remove it from memory to free space for 
other jobs. Type: 

• UNLOAD pros® 

where p ro 3 is the name of your program 

6.6.4 Virtual Overlays 

Your FORTRAN IV program can use a virtual overlay segment that calls 
REAL-11/MNC subprograms. (For more information on virtual overlays, 
see Chapter 11, Linker, in the RT-11 System User's Guide.) However, you 
must observe the following restrictions as you write the program: 

• All REAL-11/MNC buffer-management and I/O subprograms that your 
program calls must be in the same segment. 

• The segment that calls the REAL-11/MNC subprograms must be the only 
segment in its region while the REAL-11/MNC software is transferring 
data. In other words, that segment should not be competing with any 
other segment for its region while the segment is active. 

• Your program must be linked with MNCOVR.OBJ, which causes multi- 
ple references to the global ISR p-sects and forces them into the root 
segment. 

• You must link completion routines called by REAL-11/MNC subpro- 
grams to the root. 

• Your program must conform to all restrictions normally related to the use 
of overlays. 

• Foreground programs that call RE AL-1 1/MNC subprograms cannot use 
virtual arrays. 

The following procedure illustrates how to create and execute a program 
that uses virtual overlays. This program is a modification of the program 
BMEXl.FOR, which is included on the FEP distribution disk and is also 
presented in Chapter 5 of the REAL-11/MNC Programmer's Reference 
Manual. Some comments in this program refer to "REAL-11/MNC subpro- 
grams described in this chapter." The "chapter" referred to is Chapter 5 of 
the RE AL-1 1/MNC Programmer's Reference Manual. 

NOTE 

Although the procedure instructs you to use the editor to 
create the root segment and virtual overlays, they are also 
contained on the FEP distribution disk. 

1. Use the editor to create the root segment, VOEXl.FOR (see 
Figure 6-1). 



System Precautions for Users of RE AL-1 1/MNC 6-9 



The root segment declares the virtual overlays, V0EX2.F0R and 
V0EX3.F0R (see Figures 6-2 and 6-3) in a FORTRAN IV EXTERNAL 
statement. The root segment also contains a FORTRAN IV COMMON 
statement that declares the REAI^ll/MNC data buffers and sweep- 
status array. Finally, the root segment calls each virtual overlay and 
ends. 

Figure 6-1: The Root Segment, VOEXl.FOR 

C MDEXl.FOR yiRTUAL Q^ERLAY EXAMPLE FOR REAL/RT 

C RT-11 XM ONLY 

C 
. C THIS IS THE ROOT SEGMENT 
C 

C THE ENTIRE ROUTINE SHOULD BE LINKED FOR XM AS FOLLOWS: 
C 
C .RLINK 

c ♦yoExi ,goExi = goExi >mncour ,mncsng/o// 

C #g0EX2/M:l 

C »M0EX3/M!l 

C »// 

C ♦Load section : add ress? *DATA:40000 

C #Load sect i on : add ress? ® 

C »"C 

C 

C 

C 

C DECLARE THE SUBROUTINE SEGMENTS AS EXTERNAL 

C 

EXTERNAL MOEXZ 

EXTERNAL yOEX3 
C 
C 
C CREATE A COMMON BLOCK FOR SWEEP STATUS AND DATA 

DIMENSION INFO (40) »IBUF( 100 ,4) ,ISTAT(4) 

COMMON /REAL/INFO tIBUF.ISTAT 
C 

c 
c 

C NOW CALL THE FIRST OVERLAY SEGMENT 

CALL i.'0EX2 
C 
C 
C NOW CALL SECOND OVERLAY SEGMENT 

CALL M0EX3 
C 

c 

C ALL DONE 
C 

STOP 'UDEXl COMPLETED' 

END 

2. Use the editor to create the virtual overlays, V0EX2.F0R and 
V0EX3.F0R (see Figures 6-2 and 6-3). 

Note that each virtual overlay contains exactly the same COMMON 
statement used in the root segment and that each virtual overlay calls 
various REAL-11/MNC subprograms. 

Figure 6-2: The Virtual Overlay, VOEX2.FOR 

SUBROUTINE MOEXZ 
C 

C VIRTUAL OVERLAY EXAMPLE FOR REAL/RT 
C 
C THIS IS OVERLAY SEGMENT ONE FOR REGION ONE 
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c 

C THIS ROUTINE IS AN ADAPTflTIDN OF THE BMEXl EXAMPLE ROUTINE 

C 

C CHANGES ARE! 

C 1) SUBROUTINE INSTEAD OF MAIN ROUTINE (INCLUDE RETURN) 

C 2) COMMON BLOCK FOR STATUS AND DATA 

C 3) FIRST PORTION OF ORIGINAL BMEXl ROUTINE 

C 

c 
c 
c 
c 

C ! BUFFER MANAGEMENT SUBPROGRAMS: EXAMPLE 

C 

C This example demonstrates the use of the subproSrams described in 

C this chapter. It assumes that your hardware oonf i Surat i on contains 

C at least one MNCDI and one MNCKWt and that you have Senerated your 

C REAL-1 1 /MNC library aooordinsly. The hard ware is required since 

C buffer management is always involued in the transfer of data through 

C the MNC-series modules. 

C 

C The primary aim of this example is to hishlisht the use of the 

CREAL-ll/MNCsubpro3rams described in this chapter. The example 

C should not detect any errors if your hardware confisuration and 

C yourREAL-ll/MNC library match the requirements stated in the pre- 

C uious paragraph. Therefore t in many instances throushout this 

C example, error checKind is omitted. In practice, especially in 

C proSrams which haue not yet been debuSSed. you should include more 

C error checking than is demonstrated by this prosram. 

C 

C The example befins by defining certain arrays required by the sweep 

C process. INFO is used as the sweep-information array. IBUF(1 »N+1) 

C is used as the Nth buffer, and ISTAT is used to obtain buffer-status 

C info rmat i on . 

C 

C 

COMMON /REAL/INFO. IBUF .ISTAT 
DIMENSION INFO(aO) .IBUF (100.4) .IBTAT(4) 
C 

C Next f usin9 the SETIBF subroutine . the program directs the buffer- 
C management software to use INFO as a sweep- info rmat ion array and to 
C use IBUF(1»N+1) as the Nth buffer associated with that sweep. 
C 

CALL SETIBFdNFD.IND. . IBUF ( 1 . 1 ) .IBUF ( 1 .2 ) .IBUFd .3) ,IBUF(1 .4) 
C 

C The example now. usins the RLSBUF subprosfram. puts, or releases. 
C buffers number 2. 1 i and into the device queue in that order. 
C 

CALL RLSBUF (INFO . I NO .2.1 .0) 
C 

C Buffer «2 is now taKen out of the deuice queue with the RM^BUF 
C subproS ram. 
C 

CALL RMgBUF(INF0.2.IND) 
C 

C The buffers remaininS in the device queue, buffers 1 and 0. are now 
C arranged in ascending order in the queue usins the INXTBF 
C subp ro 9 ram . 
C 

CALL INXTBF(INFO.O.IND) 
C 

C The proSram now starts the sweep, acquiring a buffer of data every 
C 20 seconds. The sweep will continue unitl the operator asks to call 
C the STPSWP subroutine. Note that MNCDI unit will be sampled. 
C 

CALL CL0CKA(5.-20.IND) 

CALL DISWP(INFO.IOO) 

IFdNFOd) .NE.O) STOP 'DISWP - LIBGEN OR CONFIGURATION ERROR. ' 
C 

C The proSram now releases the remaininS buffers to the device queue 
C for this sweep. Note that this action is not required at this time. 
C 
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1 CALL RLSBUF(INF0.IND.2.3) 
C 

C 

C < BALANCE OF ORIGINAL ROUTINE IS NOW IN MDEX3 . WHICH 

C IS DMERLAY SEGMENT 2 , REGION 1. } 

C 

RETURN 

END 

Figure 6-3: The Virtual Overlay, VOEX3.FOR 

SUBROUTINE U0EX3 
C 

C VIRTUAL DMERLAY EXAMPLE FOR REAL/RT 
C ' 

C THIS IS OVERLAY SEGMENT TWO FOR REGION ONE 
C 

C THIS ROUTINE IS AN ADAPTATION OF THE BMEXl EXAMPLE ROUTINE 
C 

C CHANGES ARE; 

C n SUBROUTINE INSTEAD OF MAIN ROUTINE (INCLUDE RETURN) 

C 2) COMMON BLOCK FDR STATUS AND DATA 

C 3) SECOND PORTION OF ORIGINAL BMEXl ROUTINE 

C 
C 
C 
C 
C 

C IBUFFER MANAGEMENT SUBPROGRAMS: EXAMPLE 
C 

C { FIRST HALF OF ORIGINAL BMEXl ROUTINE IS NOW IN UDEX2,F0R , 
C WHICH IS OVERLAY SEGMENT 1 . REGION 1. } 
C 
C 
C 

COMMON /REAL/INFO. IBUF fISTAT 

DIMENSION INFO (40) .IBUF( 100 ,t\) ,ISTAT(4) 
C 
C 

C The operator now controls the sweep-related actiuity t by indicating 
C the next function to be performed) as follows: 
C a) typin3 a "1" causes the subproSram IGTBUF to be called t 
C b) typinS a "2" causes the subproSram IWTBUF to be called t 
C c) typinS a "3" causes the subproSram IBFSTS to be called t and 
C d) typins a "4" causes the subproSram STPSWP to be called t thus 
C stoppiriS the sweep and the proSram. 
C 

C If any errors occur durins the sweep* they will be reported when 
C they are detected and the proSram will stop. 
C 

C Prompt the operator. 
C 

2 TYPE 1000 

1000 FORMAT{/' TYPE 1 FOR IGTBUF, 2 FOR IWTBUF, 3 FOR IBFSTS OR 4 FOR 
1 STPSWP '*) 

ACCEPT 2000, NEXT 
2000 FORMAT( II ) 

IF(NEXT.LT.1.0R.NEXT.GT.4) GO TO 2 
TYPE 1001 

1001 FORMAT(/) 

GO TO (10,20,30,40) ,NEXT 



C 

C This proSram section is executed if the operator indicates to call 
C the IGTBUF subproSram. First ohecK for a buffer in the user queue. 
C Report if one is found and on the current status of sweep. If a 
C buffer is found, report the buffernumber and release it to the 
Cdeuiceiueue, since IGTBUFhas already extracted it from the user 
C queue . 
C 
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10 IF( IGTBUF( INFO 1 1 . 1 ND ) . LT . ) GO TO 12 
, 11 TYPE 1002.1 

1002 FORMAT( ' BUFFER «'I1 ' EXTRACTED FROM USER QUEUE. ') 
CALL RLSBUF(INFO.IND.I) 

GO TO 12 

12 TYPE 1003 

1003 FORMATf ' NO BUFFERS CURRENTLY IN USER QUEUE. ' ) 

13 TYPE 1004 ,INFO( 1) 

1004 FORMAT ( ' CURRENT SWEEP STATUS CODE IS '13'. ') 
IF( INFO( 1 ) .NE.O) STOP 'SWEEP HAS ENDED. ' 

GO TO 2 
C 

C This proSram section is executed if the operator indicates to call 
C the IWTBUF subproSram. Wait for a buffer to be placed into the user 
C queue and then report on the buffer found and the current sweep 
C status. 
C 

20 CALL IWTBUF (INFO,, I tlND) 

GO TO 11 
C 

C This proSraiii section is executed if the operator indicates to call 
C the IBFSTS subpro Sram. Print the current status of each buffer 
C and the current status of the sweep. 
C 

30 CALL I BESTS ( INFO .ISTAT.IND) 

TYPE 1005 ,( I-l , I STAT (I ) ,1 = 1 .4) 

1005 FORMAT< ' THE BUFFER STATUS CODE FOR BUFFER «'I1 ' IS '12'. ') 
GO TO 13 

C 

C This program section is executed if the opeTator indicates to call 

C the STPSWP subpro 3 ram . The prosrarii first calls STPSWP for a stop at 

C the end of the next buffer, and then flushes the user lueue in order 

C to check on the final status of the sweep. 

C- 

40 CALL STPSNPdNFO.l ,IND> 

41 IF(IWTBUF( INFO , ,1 ,IND) .GE.O) G0T041 
GO TO 13 

C 

RETURN 
END 

3. Compile the root segment and virtual overlays by typing: 

.FORTRAN UOEXKrS 
.MAIN. 

.FORTRAN UaEX2Eai 
UOEXZ 

.FORTRAN yOEXaESl 
M0EX3 

4. Use the linker to create the virtual overlay structure and produce a 
background job by typing: 

,R LINKdl) 

*U0EX1 ,yOEXl = i,iOEXl ,MNCOMR ,MNCBNG/Q//(il!l 

#M0EX2/Vii Idll 

#yOEX3/U: Idl) 

*//m 

Load section : add ress? $DATA:4000C 
Load seotion:ad dress ?(® 



System Precautions for Users of REAL-11/MNC 6-13 



5. Execute VOEXl by typing the following. (The results printed here are a 
sample of those you can obtain by running the program.) 

.RUN UOEXKH) 

TYPE 1 FDR IGTBUF* Z FOR IWTBUF, 3 FOR IBFSTS OR H FDR STPSWP i® 

NO BUFFERS CURRENTLY IN USER QUEUE. 
CURRENT SWEEP STATUS CODE IS 0, 

TYPE 1 FOR IGTBUFt 2 FOR IWTBUF t 3 FOR IBFSTS OR 4 FOR STPSWP 3m 

THE BUFFER STATUS CODE FOR BUFFER «0 IS "1. 

THE BUFFER STATUS CODE FOR BUFFER »1 IS 2. 

THE BUFFER STATUS CODE FOR BUFFER #2 IS 2. 

THE BUFFER STATUS CODE FOR BUFFER »3 IS 2. 
CURRENT SWEEP STATUS CODE IS 0. 

TYPE 1 FOR IGTBUF. Z FOR IWTBUF, 3 FOR IBFSTS OR 4 FOR STPSWP Zdl) 

BUFFER «0 EXTRACTED FROM USER QUEUE. 
CURRENT SWEEP STATUS CODE IS 0. 

TYPE 1 FOR IGTBUFt 2 FOR IWTBUF, 3 FOR IBFSTS OR d FOR STPSWP a® 

CURRENT SWEEP STATUS CODE IS 315. 
STOP -- SWEEP HAS ENDED. 



6.7 RT-11 System Errors Related to MNC-Series Modules 

This section describes errors that may indicate the absence of MNC-series 
modules required by the REAL-11/MNC software. These error messages 
are printed at the system terminal. 

6.7.1 Illegal Memory Reference 

The FORTRAN IV OTS (Object Time System) displays this error as: 

?Err SI Illegal meiiiory reference 

If you are executing REAL-11/MNC software when the error occurs, the 
executing program stops and control returns to the monitor. The error may 
indicate that an MNC-series module required by the software is not pres- 
ent; to recover from this condition, determine the missing MNC-series 
module, and install it. (Be sure to power off your MINC computer system 
before removing or inserting an MNC-series hardware module; see the 
DECLAB-11/MNC User's Guide for more information.) An illegal memory 
reference may also indicate that CSR and vector address switches are set 
incorrectly; see the DECLAB-lllMNC User's Guide for more information. 
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6.7.2 Processor Halt 

If the processor halts, the terminal displays the following message and no 
further program or system activity occurs: 

n n ri n n n 
i 

where n n n n n n is the address plus 2 at which the processor stopped. 

If this happens while you are executing REAL-11/MNC software, an 
MNC-series module required by the software may not be present. To re- 
cover, reboot the system (see Section 2.1), determine the missing 
MNC-series module, and install it. (Be sure to power off your MINC com- 
puter system before removing or inserting an MNC-series hardware mod- 
ule; see the DECLAB-lllMNC User's Guide for more information.) 

6.8 REAL-11/MNC Performance with the FB and XM Monitors 

When you are using the FB or XM monitor, a program that calls REAL-11 
MNC subprograms can be running at the same time another program is 
running. For example, a program that uses REAL-11 /MNC subprograms 
to acquire data can run as a foreground job while a data-reduction program 
is running as a background job. Because active programs compete for a 
share of system resources, however, the REAL-11/MNC program executes 
more slowly than it would if no other program were active. This situation, 
may produce data-overrun, buffer-overrun, or buffer-underrun errors dur- 
ing sweeps that transfer data at high rates. (For more information on these 
errors, see Section 2.2.10, Status Codes for the Sweep-Status Word, in the 
REAL-11/MNC Programmer's Reference Manual.) To obtain the maximum 
performance from a program that calls REAL-11/MNC subprograms, run 
that program alone. 
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Chapter 7 
Using RGL/11 



This chapter contains information on developing, linking, and executing 
programs that call RGL/11 software. , 

7.1 RGL/11 Files Needed for Program Development 

The RGL/11 software includes three files that are the minimum you need 
when you develop a program that calls RGL/11 subroutines. The three 
files are: 

• RGLLIB.OBJ, the RGL/11 library 

• BLODAT.OBJ, the block data module 

• ERRTXT.TXT, the RGL/11 error messages 

In addition, if you plan to use the Greek character font, you also need 
GREEK.FNT. 

If you have two RL01/RL02 disk drives, you have installed these files on 
the development system disk. (See Section 4.7 on installing RGL/11.) You 
may also have placed RGLLIB.OBJ in SYSLIB. 

If you have only RX02 diskettes, you have installed these files on the sepa- 
rate diskette 1/5 that contains only the RGL/11 software needed to run non- 
overlaid RGL/11 programs. 

The files listed in this section are sufficient only to execute RGL/11 subrou- 
tines with programs that are not overlaid. To execute RGL/11 software with 
overlaid programs, you also need additional object modules. However, if 
you have installed RGL/11 for use with overlays, you have already installed 
those files, which are on the disk that contains PRMLIB.OBJ, 
BLODAT.OBJ and ERRTXT.TXT. 
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7.2 Developing a Program that Calls the RGL/11 Software 

Execute the following procedures when you develop a program that calls 
any RGL/11 subroutines: 

If you have RL01/RL02 disks: 

1. Bootstrap the development system disk in drive 0. 

2. Create the source file for your program on the development system 
disk, which also contains the files listed in Section 7.1. 

If you have RX02 diskettes: 

1. Bootstrap the development system diskette in drive 0. 

2. Mount in drive 1 the diskette that contains the files listed in Section 
7.1. Use the following diskette: 

• diskette 1/5 for a non-overlaid RGL/11 program 

• diskette 2/5 for a standard overlaid RGL/11 program 

• diskette 3/5 for an alternate extended-memory overlaid program 

If your program calls software that is part of other FEP-11/FRP compo- 
nents, such as REAL-11 or IBS, those components must also be on the 
diskette. 

3. Designate the diskette in drive 1 as the default diskette by typing: 

.ASSIGN DYl! DK:® 

Create the source file for your program on the diskette in drive 1. 

7.3 Linking a Program that Calls the RGL/11 Software 

There are three methods for linking programs that call RGL/11 subrou- 
tines. These methods are: 

• Running the command file RGLLNK.COM, which you can use whether or 
not you overlay your program. RGLLNK also compiles and executes your 
program. 

• Running the linker, which you should use only if you do not overlay your 
program. 

• Editing and running the command file RGL0VR.COM, which you should 
use only if you use the alternate extended-memory overlay structure. 

The three methods are described below. 
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7.3.1 The Indirect Command File, RGLLNK 

RGLLNK creates an executes a command file called RGL.COM that en- 
ables you to compile, link, and execute your program. If you are running 
under the XM monitor and you want to use overlays, you have the option of 
using low memory overlays or extended-memory overlays. If you choose 
extended-memory overlays, your program will be created as a virtual job. If 
you are running under FB or SJ and want to use overlays, you can use only 
low memory overlays. You can default all answers to RGLLNK except the 
program name. The default for each question is given in square brackets at 
the end of each question. 

To invoke RGLLNK, type: 

.gRGLLNKd!) 

A sample RGLLNK dialog follows. It compiles, links, and runs a program 
named prog: 

.eRGLLNKED 

Do you want to c o m p i 1 e C Y ] ? (REjl 

Do you want listings CN] ? ED 

Type Yd!) if you want listings and ® if you do not. If you answer Yes, 
RGLLNK prompts with the further question: 

What device do you want the listings to So to [LP:] ? 

Type (RET) to have the listing go to the line printer, or type the name of the 
device, such as DLO: where you want the listings sent. 

Do you want to link CY] ? dll 
Do you want a map IHl ? (HD 

Type Y® if you want a load map; type (H) if you do not. If you answer Yes, 
RGLLNK prompts with the further question: 

What deuice do you want the listings to 3o to [LP] ? 

Type E) to have the load map go to the line printer, or type the name of the 
device, such as DLO:, where you want it sent. 

D y u w a n t 1.1 e r 1 a y s C Y ] ? (all) 

Type ® to overlay your programs; type NO to avoid overlays. A Yes 
answer link your program to PRMLIB.OBJ., and RGLLNK prompts with 
the further question: 

Do you want extended mewory OMerlays [N] ?CliII 



Using RGL/11 7-3 



Type Y® if you are running under XM and want extended-memory over- 
lays, other wise type (®. 

Do you want to run CY] ? SU 

Type <M) if you have a VT125 and want to run the program; type N® if you 
do not. 

If you are running under SJ, FB, or XM and want to compile, link, and run 
a program called PROGl using low memory overlays, RGL.COM would 
look like: 

FORT/CODE:THR PROGl 

R LINK 

PROG 1 = PROGl tBLODAT jPRHLIB/B: 1200/A/W/P: 1000// 

LFIXED ,L0CAT2/0! 1 

LFREE»L0CATE/0: 1 

PPOINT/0: 1 

PDATA/0:1 

DPAPER/Osl 

LNAXIS/Oil 

LTAXIS/0: 1 

LNNICE,LINMIN.LINHAK/0:2 

PRINUM jPRISTR .text .XLABEL ,YLABEL/0!2 

FHINMX .LGNICE .EXPTST/0!2 

DPALOG .DPALIN .DEFALT .DRWB0X/0s2 

LINE .HARKER .MOVE .SWIND0/D:3 

GEN0yR/0!3 

INITGR.CLIPIT,SSTATE/0:3// 

"C 

RUN PROGl 

If you are running under XM and want to compile, link, and run PROGl 
using extended memory overlays, RGL.COM would look like: 

FORT/CODE:THR PROGl 

R LINK 

SY 5 PROGl = PROGl .BLODAT.PRHLIB/I/A/W/PslOOO// 

LFIXED »L0CAT2/U! 1 

LFREE.LOCATE/Msl 

PPOINT/M: 1 

PDATA/Unl 

DPAPER/U: 1 

LNAXIS/M: 1 

LTAXIS/U;1 

LNNICE »LINMIN.LINHAX/U:2 

PRINUM.PRISTR,TEXT.XLABEL.YLABEL/Ms2 

FMINMX.LGNICE ,EXPTST/Ui!2 

DPAL0G,DPALIN.DEFALT.DRWB0X/U!2 

LINE .MARKER .HOME .SWIND0/U:3 

GEN0MR/M:3 

INITGR .CLIPIT.SSTATE/M:3// 

$OBLK 

-c 

R PROGl 
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7.3.2 Linking a Program that Calls RGL/11 Software without 
Using Overlays 

If you have decided not to overlay your program, you can link it by running 
the linker yourself instead of running RGLLNK. Running the linker your- 
self makes the process of linking your program faster. 

To link a program that calls RGL/11 subroutines, type the following: 

.R LINKdH 

#f,iypro3 = mv'proSf BLODAT .RGLL I B/B : 1 200/ P : 1 000 [ , f i 1 e spe c ]© 

where m y p r o 3 is the rp a m e of v o u r p r o 3 r a rti 

BLDDAT is the name of the object file that defines the initial 
Graphic defaults 

RGLLIB is the name of the Graphics library for non-ouerlaid 
programs 

/B:1200 ensures there will be enouSh room in the monitor stacK 

/P:1000 allows table space for the linker proSram 

filespec is the name or names (separated by commas) for optional 
s (lb routines* or for optional libraries (which require the /LB 
switch) 

If the linker encounters no fatal errors, it produces an executable program 
or "load module" called myprog.SAV. The RGLLNK command file can also 
produce a non-overlaid program, so you have a choice which procedure 
to use. 

7.3.3 RGL0VR.COM 

Using the indirect command file RGLOVR is the third way to link a pro- 
gram. Use it for programs that use extended-memory overlays. This over- 
lay structure will overlay additional RGL/11 routines. You should use this 
overlay structure only if you are running under XM, are going to use ex- 
tended memory overlays, and: 

1. Your program is too large using the extended memory overlay struc- 
ture provided by RGLLNK and you would like to overlay more RGL/11 
routines, or 

2. Your program is too large and you would like to overlay more RGL/11 
routines and add your own virtual overlay segments to overlay 
region 4. 

The contents ofRGLOVR.COM are: 

R LINK 

SY:HAINPR = MAINPR ,BLODAT >REKLI B/ I / A/W/P s 1000// 

LFIXED ,L0CAT2/Mii 1 

LFREE tLOCATE/O: 1 

PPOINT/y:l 

PDATA/M: 1 
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DPAPER/Msl 

LNAXIS/M: 1 

LTAXIS/U: 1 

ARCOyR/M:l 

RELOUR/Uil 

SAMOMR/M: 1 

GN20UR/M:1 

LNNICEjLINHIN .LINMAK/M:2 

PRINUM tPRISTR ,TEXT tXLABEL »yLABEL/U:2 

FMINMX tLGNICE -EXPTST/M:2 

DPALDG*DPALIN .DEFALT .DRNBOK/M : 2 

LINE jHARKER .MOUE .SWINDD/M:3 

GEN0UR/M:3 

INITGRtCLIPIT .SSTATE/Vi!3// 

$COBLK 

-c 

If you want to just overlay more RGL/11 subroutines, do the following: 

1. Make a copy of RGL0VR.COM 

2. Edit the copy by replacing all occurrences of "MAINPR" with the name 
of your own program. 

After the copy has been edited, it is ready to be run. 

If you want to overlay more RGL/11 subroutines and overlay parts of your 
application program, do the following: 

1. Make a copy of RGL0VR.COM 

2. Edit the copy to: 

• Replace all occurrences of MAINPR with the name of your program 

• Include your segments in virtual overlay region 4. Remember to re- 
move the "//" at the end of line "INITGR,CLIPIT, SSTATEA^:3//" and 
place it after your last user segment. If you choose to do this, you 
reduce the address space of the root by 4K (see the RT System User's 
Guide, Extended Memory Overlays). 

An example of a RGLOVR command file containing user overlay segments 
follows. The file is an edited copy of RGLOVR and is named PR0G1.COM. 
The name PROGl replaces MAINPR throughout, and two user overlay 
segments are added to region 4. 

R LINK 

SY s PROG 1 = PROGl .BLODAT ,REXLI B/ I /A/W/ P : 1000// 

LFIXED jL0CAT2/M!l 

LFREE .LDCATE/ysl 

PPOINT/y :1 

PDATA/Unl 

DPAPER/y:l 

LNAXIS/U;1 

LTAXIS/U:1 

ARCOMR/M: 1 

RELOMR/M: 1 
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SAVOMR/M! 1 

GNZOMR/M: 1 

LNNICE »LINMIN>LINMAX/U!Z 

PRINUM»PRISTR,TEKT»XLABEL,YLABEL/Us2 

FHINMX ,LGNICE»EXPTST/y:2 

DPALOG »DPALIN .DEFALT ,DRWB0X/U:2 

LINE (MARKER .MOUE ,SWIND0/M:3 

GEN0MR/U:3 

INITGR (CLIPIT ,SSTATE/y!3 

USER1/M:a 

USER2/U:a// 

$OBLK 



Execute PROGl by typing: 

.@PR0G1(RID 



When PROGl successfully completes, it produces an executable program or 
load module with the name you supplied and a .SAV extension on the 
system device. 

RGL/11 extended-memory overlays are run as virtual jobs and use the R 
command, rather than the RUN command. The R command can load pro- 
grams only from the system disk. To run a file named PROGl. SAV that 
was created by PR0G1.COM, you would type: 

.R PROGKHD 

7.4 Running a Program that Calls RGL/11 Software 

If you are running under the FB or XM monitor or SJ with multi-terminal 
support, you must set your terminal to prevent RT-11 from sending car- 
riage-return/line-feed characters. To do so, type: 

.SET TT NOCRLFdl) 

To avoid typing this command every time you use RGL/11, add it to your 
startup indirect command file, which is either STARTS.COM, 
STARTF.COM, or STARTX.COM. 

To run most RGL/11 programs, type: 

.RUN pros iS) 

where pros is the nawe of your prosram 
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If your program uses RGL/11 extended-memory overlays, however, it must 
be run from the system disk. The reason for this is that RGL/11 creates the 
program as a virtual job and RT-11 looks on the system disk for virtual 
jobs. The command line to run a virtual job uses the "R" form of the RUN 
command; 

. R p r 3 (M) 

where pros is the name of the prosram usinS RGL/11 ex t en d e d -Memo rv 
u e r 1 a y s 

When you issue either form of the RUN command, RT-11 attempts to exe- 
cute the load module, prog.SAV. If it encounters a condition that prevents 
it from doing so, it prints a FORTRAN OTS (Object Time System) error 
message. For help in understanding the error message, see the 
RT-11, RSTS/E FORTRAN IV User's Guide. 
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Chapter 8 

Using PLOT55 with a VT105 



PLOT55 is a FORTRAN-callable subroutine distributed with the RT-11 
operating system. The PLOT55 software is designed for use with the VT55 
terminal, the predecessor of the VT105 terminal. However, PLOT55 can 
also be used with the VT105 because the hardware designs of the two 
terminals are compatible. By using the PLOT55 package, you have access 
to the capabilities of the VT105 terminal that are also found in the VT55 
terminal. This subset contains the majority of the VT105 features. 

NOTE 

PLOT55 is designed for use with a terminal that has 236 
vertical positions. However, if you use the VT105 in rectang- 
ular mode, as the VT105 Graphic Terminal User's Manual 
recommends, the terminal has only 230 vertical positions. 

Do not attempt to use PLOT55 with a VT125 terminal. PLOT55 can be 
used only with a VT55 or another terminal, such as a VT105, that can 
emulate a VT55. The VT125, even though it can emulate a VT105, cannot 
emulate a VT55. 

The PLOT55 software sends commands to the terminal as if it were a VT55 
terminal. Therefore, to ensure that the VT105 terminal correctly interprets 
commands from the PLOT55 software, put the VT105 terminal into VT52 
mode before any part of the PLOT55 software is executed. You may do this 
either manually or under program control. 

After running programs using PLOT55, always return the VT105 to ANSI 
mode. 
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8.1 Manually Changing the VT105 Mode 

To manually change the VT105 operating mode: 

1. Press the SET-UP key to put the terminal into SET-UP A mode. 

2. Press the 5 key on the main keyboard to put the terminal into SET-UP 
B mode. 

3. The terminal displays four groups of binary values. Look at the third 
entry in the second group of values. If that value is zero, the terminal 
already is in VT52 mode; press the SET-UP key again to return the 
terminal to normal operation, and ignore steps 4, 5, and 6 below. If that 
value is one, put the terminal in VT52 mode by performing steps 4, 5, 
and 6 below. 

4. Repeatedly press the right-arrow (->) key, which is located at the upper 
right corner of the main keyboard, until the cursor is positioned over 
the third entry in the second group of switches. 

5. When the cursor is correctly positioned, press the 6 key on the main 
keyboard to change the value from a one to a zero. 

6. Press the SET-UP key again to return the terminal to normal opera- 
tion, which is now VT52 mode. 

To return the VT105 terminal to ANSI Mode, which is the default VT105 
operating mode, perform the same procedure, but change the third entry in 
the second group of binary values to a one. Note that when the VT105 is in 
SET-UP B mode, pressing the 6 key changes the value over which the 
cursor is positioned from one to zero or from zero to one. 

8.2 Changing the VT105 Mode under Program Control 

To change the VT105 operating mode under program control: 

Send the terminal-specific escape sequences. (An escape sequence is a 
series of ASCII characters, the first of which must be the escape character, 
33 octal.) 

When you send the following five-character escape sequence to the VT105 
terminal, its operating mode changes from ANSI to VT52: 



When you send the following two-character escape sequence to the VT105 
terminal, its operating mode changes from VT52 to ANSI: 



NOTE 

The terminal automatically returns to its predefined opera- 
ting mode whenever the terminal is powered on. 

»-2 Using PLOT55 with a VT105 



For detailed information on operating the VT105 terminal, see the 
VT105 Graphic Terminal User's Manual. 

The FEP-11 distribution media that contain the REAL-11/MNC software 
also include a MACRO-11 routine called VTMODE. This routine consists 
of two FORTRAN-callable subroutines that provide programmable control 
of the mode of your VT105. You can use these subroutines either as they 
are presented here or as a model for creating your own FORTRAN-IV or 
MACRO-11 subroutines. 

NOTE 

If you write a FORTRAN IV program that sends escape 
sequences to the terminal, remember that the first character 
in the sequence does not go directly to the terminal. The first 
character is normally intercepted by FORTRAN-IV and used 
as a form-control character. 

A program can use the VT52 subroutine to change the current operating 
mode of the VT105 from ANSI to VT52 mode. Invoke this subroutine with 
the following FORTRAN statement: 

CALL MT52 

A program can use the ANSI subroutine to change the current operating 
mode of the VT105 from VT52 to ANSI mode. Invoke this subroutine with 
the following FORTRAN statement: 

CALL ANSI 



Following are the contents of VTMODE.MAC: 

.TITLE UTMODE 
.HCALL .TTYDUT 
.GLOBL UT52 .ANSI 



MT52: 



ANSI 



LOOP: 
START 1 



MT52ES: 
ANSIES: 



MOM *UT52ES»R1 
BR START 



MOM 
BR 



«ANSIES»R1 
START 



.TTYDUT 
MOMB (Rl )+ fRO 
BNE LOOP 
RTS PC 



SUBROUTINES TO CHANGE THE OPERATING 
MODE OF THE MTIOO (UT105) TERMINAL. 
ROUTINE FOUND IN FILE "SYSMAC.SML" 



DEFINE SUBROUTINE NAMES 

GET ADDRESS OF ESC. SEP. FOR yT52 MODE 
GO SEND UTIOO ESCAPE SEQUENCE 

GET ADDRESS OF ESC. SEP. FOR UTIOO MODE 
GO SEND yTlOO ESCAPE SEQUENCE 

SEND A SINGLE CHARACTER TO THE TERMINAL 
GET NEXT CHARACTER IN ESCAPE SEQUENCE 

IF IT IS NOT ZERO* GO SEND IT. 

IF IT IS ZERO , WE ARE DONE t SO RETURN. 



.BYTE 
.BYTE 

.END 



33 .133 .77.S2 .15/3 .0 
33 .74.0 .0 



5ESC. SEQ. FOR yT52 MODE 
;ESC. SEQ. FDR ANSI MODE 



Assemble VTMODE.MAC and use the object file VTMODE.OBJC as you 
would use any other object file. 
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For example, assume that you have a FORTRAN-IV program called 
MYPROG that uses the FLOT55 subroutine. LINK your program by typing 
the following: 

, L I NK / EXECUTE :d II «MY PROG dy*: (MYPROG tPLQT55 .MTMODE)® 

This RT-11 interactive command assumes the following: 

1. The FORTRAN-IV library file, FORLIB.OBJ, has been included in the 
system library file, SYSLIB.OBJ. 

2. The system library file resides on your system device. 

3. The files MYFROG.OBJ, PLOT55.0BJ, and VTMODE.OBJ also reside 
on device dv#. 

4. You want the resulting executable file, MYPROG.SAV, to reside on 
device dv#. 
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Appendixes 



Appendix A 

REAL-11/MNC Software Generation Procedure 



This appendix explains the procedures for building and using the 
REAL-11/MNC software. The chapter describes the REAL^ll/MNC distri- 
bution kit, the dialog for generating the REAL-11/MNC software that is 
appropriate for your application, and the procedure for linking the 
REAL-11/MNC software with your FORTRAN IV program. The chapter 
also provides examples of MNCGEN. 

A.1 The Distribution i\/ledia for REAL-11/IVINC 

The REAL-11/MNC software is distributed on one RL01/RL02 hard disk or 
two RX02 diskettes. 

Each medium contains all the files required to generate the 
REAL-11/MNC software suitable for your application, including all the 
source files for the REAL-11/MNC software. The RL01/RL02 disk contains 
all the following files; RX02 diskette number 1 contains the first group of 
files; RX02 diskette number 2 contains the second group: 



ADEXl 


.FOR 


ITEXl .FOR 


MGEN07 


.MAC 


MGENia. 


,FOR 


MNCSNG 


, UER 


ADEX2 


.FOR 


KWEXl .FOR 


MGENB.i 


-OR 


MGENig. 


,FOR 


MSEXl 


.FOR 


BMEXl 


.FOR 


KWEX2.F0R 


MGEN9,i 


-OR 


MGEN20. 


,FOR 


MSEX2 


.FOR 


BTEXl 


.FOR 


MGENBD.COM 


MGENIO 


.FDR 


MNCLIB. 


,MER 


MSEX3 


.FOR 


BTEX2 


.FOR 


MGENOO.FOR 


MGENll 


.FDR 


MNCMUL. 


, DSC 


MTMP 


.DIS 


CIOEXl 


.FOR 


MGENOI.FOR 


MGEN12 


.FOR 


MNCMUL. 


, OBJ 


MVERN 


.DIS 


DAEXl 


.FOR 


MGEN02.F0R 


MGEN13 


.FOR 


MNCMUL. 


, UER 


MOEXl 


.FOR 


DIEXl 


.FOR 


MGEN03.F0R 


MGENlit 


.FOR 


MNCOMR. 


,MAC 


M0EX2 


.FDR 


DOEXl 


.FOR 


MGEN04.MAC 


MGEN15 


.MAC 


MIMCOMR. 


,OBJ 


M0EX3 


.FDR 


FTN2 


.DAT 


MGEN05.F0R 


MGENIB 


.FOR 


MNCSNG, 


,DSC 


UTMODE 


.MAC 


FTIM2 


.FOR 


MGEN06.F0R 


MGEN17 


.FOR 


MNCSNG. 


,OBJ 
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HDSC 


.MAC 


MNCOe 


.MAC 


MNC30 


.MAC 


MNC51 


.MAC 


MNC72 


.MAC 


HMLB 


.MAC 


MNCIO 


.MAC 


MNC31 


.MAC 


MNC52 


.MAC 


MNC73 


.MAC 


HNCA 


.MAC 


MNCll 


.MAC 


MNC32 


.MAC 


MNC53 


.MAC 


MNC7-a 


.MAC 


HNCB 


.FOR 


MNC12 


.MAC 


MNC33 


.MAC 


MNC5a 


.MAC 


MNC75 


.MAC 


HNCFOO 


.FOR 


MNC13 


.MAC 


MNcaa 


.MAC 


MNC55 


.MAC 


MNC7B 


.MAC 


MNCGEN 


.SAM 


MNC14 


.MAC 
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A.2 introduction to MNCGEN 



MNCGEN is the software-generation process for REAL-11/MNC. The 
name of the program that performs the process is MNCGEN.SAV. It allows 
you to customize the distributed REALp-11/MNC software to match the 
specific needs of your application. 

MNCGEN is an optional procedure. Normally you can use one of the dis- 
tributed REAL^ll/MNC library files, rather than performing the 
MNCGEN procedure. Therefore, before performing MNCGEN, read Section 
4.2.1, Selecting a REAL-11/MNC Library File, and determine whether you 
actually need to perform the MNCGEN. 

A.2.1 Planning for the IVINCGEN Dialog 

Before beginning the software-generation procedure, you should gather all 
the information required to respond appropriately to the dialog questions. 
The information you need includes the following: 

• What the requirements are for performing the MNCGEN (see 
Section A.3.3) 

• What options (for example, expanded comments) are available in the 
dialog 

• Which MNC-series modules are contained in the target configuration 

• What the vector and Control Status Register (CSR) addresses are for each 
MNC-series module 

Other required information is requested in the MNCGEN dialog itself. 
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Before running the MNCGEN program, you should read an entire dialog. 
Examples are given in Section A. 5 of this appendix. Understanding the 
MNCGEN dialog and the implications of the various responses is important 
for making appropriate choices. 

Also, before running MNCGEN, see Section 4.1 to verify that you have the 
minimal software needed for installing FEP-11. 

A.2.2 Executing the MNCGEN Program 

The MNCGEN program consists of a series of questions to which you must 
respond in order to create the REAL-11/MNC software for the MNC-series 
configuration in your target system. 

The procedure for running MNCGEN has two phases. The objective of 
Phase 1 is to create a new file called MDSC.MAC, which symbolically de- 
scribes the MNC-series configuration of your target system. The steps re- 
quired to create MDSC.MAC are explained in detail in Section A.3. 

The objective of Phase 2 of MNCGEN is to create a new REAL-11/MNC 
library file called MNCLIB.OBJ, which is based on your responses in Phase 
1. This file is customized to match your target configuration according to 
the answers you supply in the dialog. Phase 2 is described in Section A.4. 

It is not necessary to complete Phase 2 at the same session in which you 
complete Phase 1. Because the assembly process takes about 30 minutes 
with two EL01/RL02 disk drives or one hour with RX02 diskette drives, you 
may prefer to run Phase 2 of MNCGEN at a later time. You also have the 
option to produce a hard-copy listing of the assembled files. The dialog in 
Phase 1 allows you to choose from these options. 

You must be using the SJ or FB monitor when you execute the MNCGEN 
procedure. You also must execute the procedure on the system console ter- 
minal. To start the MNCGEN dialog, make the device assignments dis- 
cussed in Section A.3.3, and type: 

* RUN I : MNCGEN 

A.3 The MNCGEN Dialog: Phase 1 

This section explains in detail the MNCGEN dialog for Phase 1. It de- 
scribes all text, questions, and responses displayed during the dialog. How- 
ever, not all of these questions appear in every MNCGEN dialog because 
some questions depend on your responses to previous questions. 

A.3.1 Choice of Dialog Form 

The MNCGEN dialog has two forms: expanded (or long) and short. The 
expanded form provides an explanation of each dialog question before the 
question itself appears. The short form limits the dialog to the questions 
themselves; it provides no explanatory information, unless you specifically 
request "help" by typing H. 
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You must choose either the expanded or short form of the dialog. If you 
have run similar system-generation programs before and understand each 
question of the dialog and its appropriate response, you may find that the 
short form saves time. However, if you are unfamiliar with the dialog, the 
long form is recommended. 

You indicate the form you wish to use by answering the first question in 
the dialog with Y (for yes) or N (for no): 

DO YDU WANT THE HNCGEN DIALOG IN THE EXPANDED FORM?[Y/N]:N 

Your response to this question governs the remainder of the session. 

A.3.2 Question Types and Defaults 

The MNCGEN dialog for Phase 1 consists of a series of questions that you 
can answer in one of three ways (explained in the expanded form): 

• With a Y (for yes) or N (for no). This form usually concerns options of this 
procedure (see the first dialog question given above) or of the 
REAL— 11/MNC software (for example, does your target system contain 

AN MNCAG?). 

• With a decimal number. This form usually pertains to the number of 
certain hardware items (for example, how many mncdis are contained in 

YOUR target system?). 

• With an octal number. This form usually pertains to the vector and CSR 
addresses of the MNC-series modules (for example, what is the mector 

address of HNCAD «ri? and WHAT IS THE CSR ADDRESS OF MNCAA »n?). 

Terminate all responses to these questions by pressing the RETURN key on 
your terminal. 

Following each question is a range of acceptable answers enclosed in square 
brackets. Each range is first categorized by one of the following letters: 

• Y/N for yes or no. Your response must be Y or N. 

• O for octal. Your response must be an octal number. 

• D for decimal. Your response must be a decimal number. 

Following O or D is a colon and a range of acceptable values; Following the 
closing square bracket is a second colon and the default answer that the 
program uses if you respond by pressing only the RETURN key. Examples 
follow: 

DOES YOUR TARGET SYSTEM CONTAIN AN MNCAG7C Y/N] ! Y 

In this case, your choice is Y or N, and the default value is N. 
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HOW MANY MNCDIs ARE CONTAINED IN YOUR TARGET SYSTEM? [D:0-8]!8 

In this case, you must specify a decimal number in the range to 1. The 
default value is 1. 

WHAT IS THE MECTOR ADDRESS OF MNCAD «n?CO : 1 20-474] ! aOO 

In this case, you must specify an octal value in the range 120 to 474. The 
default value is 400. 

If you respond to such questions with a number that is out of the acceptable 
range, MNCGEN issues the following message: 

**ERROR#* 

RESPONSE IS OUT OF RANGE! 

It then repeats the request for the appropriate address. 

If you respond to any of these questions with a number that matches a 
number given in response to an earlier question, the following message 
appears: 

**ERRDR*# 

ADDRESS GIUEN CONFLICTS WITH PREVIOUS RESPONSES. 

MNCGEN then repeats the request for the appropriate address. 

A.3.3 Requirements for MNCGEN 

For the MNCGEN procedure to function properly, you must satisfy certain 
requirements, as explained below and in the MNCGEN dialog. 

NOTE 

You cannot execute the MNCGEN procedure or verify gener- 
ated REAL-11/MNC software (see Section A.5.5) under the 
XM monitor. Therefore, if you plan to use REAL^ll/MNC 
under the XM monitor, the SJ or FB monitor must be in 
operation while you perform the MNCGEN and verification 
procedures. 

The first requirement is to copy your distributed REAL-11/MNC software 
and your latest MDSC.MAC file onto a compatible storage medium. This 
measure ensures that you do not lose these files. 
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You then must assign specific names to the devices that will contain your 
various files. You make these assignments using the RT-H ASSIGN com- 
mand, as follows: 

I If you plan to complete Phase 2 as part of the current procedure and in 
that way create a new REAI^ll/MNC library file (MNCLIB.OBJ), 
then you must assign the name I to the device that contains a copy of 
the distributed REAL^ll/MNC software. For example: 

ASSIGN DLn: I (for RLOls) 
ASSIGN DYn si (for RX02s) 

where n is the unit number of the device. 

D You must assign the name D to the device that contains the copy of the 
MDSC.MAC file. This file is used in the current procedure for default 
answers. Usually it is either the distributed MDSC.MAC file or the 
one created by a previous MNCGEN procedure. For example: 

ASSIGN DLn: D (for RLOls) 
ASSIGN DYn : D (for RX02s) 

where n is the unit number of the device. 

N You must have assigned the name N to the device that will contain the 
new MDSC.MAC file and (after Phase 2 is completed) the new 
MNCLIB.OBJ file. MNCLIB.OBJ is the actual REAI^ll/MNC library 
file. This device will also be used in Phase 2 for intermediate file 
storage. Depending on the attributes of the REAL-11/MNC object file 
being created, between 150 and 350 blocks of contiguous storage space 
are required. 

ASSIGN DLn: N (for RLOls) 

A S S I G N D Y n 5 N (for RX0'2s) 

where n is the unit number of the device. 

L You have the option during the MNCGEN procedure to produce as- 
sembly listings. If you plan to choose this option, you must assign the 
name L to the device that will contain your listing files. For example: 

ASSIGN LP: L 

Do not assign the name N to the same device that you have named I or D. 
By creating new files on a device that contains old files with the same 
names, you replace the old files. 

The MNCGEN dialog prompts you regarding these various requirements 
with the following question: 

HAME YOU MET THE REQUIREMENTS TO PERFORM THIS PR0CEDURE7C Y/N] : N 
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If you answer with N to this question, the system issues the following 
message: 

STOP - REAL-11 GENERATION REQUIREMENTS NOT MET! 

If you answer with Y but have not assigned the names N or D to appropri- 
ate devices, the following system error message appears: 

?Err 27 Attempt to use deuioe not in si'stein 

If you answer with Y but the MDSC.MAC file is not on the device named D, 
the following system error message appears: 

?Err 28 Open Failed for file 

You cannot continue with the dialog until you have met the requirements. 
You must begin the dialog again. 

Similar messages appear during Phase 2 of the MNCGEN dialog if you 
have not assigned the names I, N, and (when you request listings) L to the 
appropriate devices. Phase 2 cannot continue until you have made these 
required assignments. 

A.3.4 Option to Postpone the Assembly Process (Phase 2) 

As mentioned earlier. Phase 2 of the MNCGEN procedure consists of the 
creation of a new REAI^ll/MNC library file called MNCLIB.OBJ. This 
file, which is based on your responses in the MNCGEN dialog, is custom- 
ized to match your target configuration. 

Because the process requires several minutes to complete, however, you 
have the option to postpone Phase 2 of the MNCGEN procedure. The sys- 
tem asks the question: 

SHOULD THIS PROCEDURE EXECUTE PHASE 2?CY/N]iY 

If you respond with N, the dialog continues only until Phase 1 is complete. 
Then, at a later time, you can complete Phase 2 by executing one of two 
indirect files supplied with your distributed REAL-11/MNC software. 
These files are MNCNOL.BLD, which you use if you do not want listings of 
your assembled files, and MNCLST.BLD, which you use if you do want 
such listings. 

These indirect command files, though run at a later time, require the de- 
vice assignments that you specify in Phase 1. If you decide to postpone 
Phase 2, therefore, be sure that you assign the name N to the device con- 
taining the MDSC.MAC file created during Phase 1. 
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If you respond with Y to the question, indicating that you want to produce 
your new object file now, the system asks you a related question: 

DO YOU WANT TO PRODUCE ASSEMBLY LISTING FILES? CY/N ]: N 

If you respond with Y to this question, the system produces your assembled 
source listing files on the device that you named as L. If device L is not a 
hard-copy device, the file names are of the form MNCxx.LST, where xx 
corresponds to the related MNCxx.MAC or MNCxx.FOR source file distrib- 
uted with the software. 

These listing files are numerous and large. In general, you should avoid 
producing these files. 

A.3.5 MNCGEN Hardware Checking 

The MNCGEN dialog attempts to determine if the target system that you 
are specifying in the current MNCGEN session matches the actual configu- 
ration of the MNC-series modules that are presently installed in your 
system: 

IS THIS SYSTEM* AS PRESENTLY CONFIGURED* THE TARGET SYSTEM OF THIS 
SOFTWARE-GENERATION PROCEDURE? CY/N ] s N 

If you answer with Y to this question, MNCGEN attempts to verify that the 
hardware-selection information provided in the dialog corresponds to the 
hardware on the system. 

As noted in the dialog, this additional checking feature requires that your 
system be used only for the MNCGEN procedure during Phase 1. 

A.3.6 Run-Time Hardware Checking 

The REAL-11/MNC software includes an optional feature that checks for 
the presence of required MNC-series hardware every time a 
REAL-11/MNC subprogram is executed. If required hardware is absent, 
the software returns an error code to the calling program. In some cases, 
the software returns the error code 305 in the sweepstatus word; in other 
cases, it returns a value of in the variable ind. See the REAL-11/MNC 
Programmer's Reference Manual for more information. 

To enable run-time hardware checking, answer Y to the following question: 

DO YOU WANT THE REAL-11 SOFTWARE TO MAKE RUN-TIME CHECKS 
FOR THE PRESENCE OF REQUIRED LAB MODULES? [Y/N]:Y 

Run-time hardware checking slows execution of REAL-11/MNC subpro- 
grams and occupies additional memory. Therefore, if possible, avoid using 
this feature. You do not need the feature if your hardware configuration 
rarely changes or if you are confident that you know which MNC-series 
hardware is needed by the REAL-11 subprograms you are using. 
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A.3.7 Specifying iVINCAD-Reiated Information 

The REAL^ll/MNC system can support one MNCAD. You specify the 
number of MNCADs by responding to the following question: 

HOW MANY MNCADs ARE CONTAINED IN YOUR TARGET SYSTEM? CD s 0- 13 ! 1 

If you answer 0, the following REAL-11/MNC subprograms will not be 
included in the resulting MNCLIB library file: 

ADINP (lADINP), ADSWP, ADFAST, ADSUM and MADSTS. 

(See Chapter 7 in the REAL-lllMNC Programmer's Reference Manual for 
information on these subprograms). Also if you answer 0, the dialog begins 
the section of questions related to the MNCKW. 

If your answer to this question is 1, you must specify the assigned vector 
and CSR addresses for your MNCAD. The default values for these ad- 
dresses are the standard locations, and usually they correspond to the 
switch settings on the module. However, if you have reason to think that 
these addresses are not set to the standard locations, see the 
DECLAB-11/MNC User's Guide for instructions on how to verify or change 
the switch settings. 

For the MNCAD, the system requests these addresses as follows: 

WHAT IS THE UECTOR ADDRESS OF MNCAD ttO?CO s 120-a7a 3 5 400 

WHAT IS THE CSR ADDRESS OF MNCAD #0?[ : 17 1 000- 1 71 400 ] : 1 7 1000 

The MNCAG is a preamplifier that provides differential-mode amplifica- 
tion or attenuation of signals on four A/D input channels. The number of 
allowable MNCAGs depends on the number of MNCAMs in your system. 
The maximum number is two for each MNCAM and one for the MNCAD. 

MNCGEN prompts you as follows: 

DDES YOUR TARGET SYSTEM CONTAIN AN MNCAG ?[Y/N]:Y 

If an MNCAG is connected to an MNCAD or MNCAM in your system, you 
can specify the gain value that you want for channels that will be used in 
A/D sampling. You can also default this gain value. If the gain-selection 
switch on the front panel of the MNCAG is set to a fixed gain, the hardware 
defines the default gain value. 

However, if the gain-selection switch on the MNCAG is set to P (for 
"programmable"), the REAL-11/MNC software must use the default gain 
value that you define during the MNCGEN dialog. 
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You set a default gain value for that situation by responding to the follow- 
ing question: 

WHAT SHOULD BE THE DEFAULT GAIN MALUE WHEN THE GAIN-SELECTION 
SWITCH OF AN MNCAG IS SET TO PROGRAMMABLE?! 
.5(0) . 5( 1) » 50(2) » OR 500(3)? [D!0-3]!0 

To specify the default gain value, you enter the number given in 
parentheses after the desired gain value. For example, to specify a default 
gain value of 5, you enter the number 1. 

The MNCTP module allows ANSI standard thermocouples to be connected 
to the A/D. 

DOES YOUR TARGET SYSTEM CONTAIN AN MNCTP?C Y/N3 s Y 

Occasionally a sweep can cause a data overrun, which occurs when the 
system cannot sample input at the requested rate. This situation is not 
indicated until the sweep is underway. The MNCGEN dialog requires that 
you select one of three ways to handle a data overrun. You can: 

1. Immediately terminate the sampling process when the data overrun is 
detected. This is the usual way to handle a data overrun. It is the only 
way that REAL-11/MNC can handle a data overrun for a clock-driven 
sweep involving any module other than MNCAD. 

If you select this option and a data overrun occurs, the value 37777 
(octal) is stored in the data buffer, and the sweep-status word returns 
an error code. (See Appendix A of the REAL-lllMNC Programmer's 
Reference Manual.) 

2. Indicate by a predetermined value in the data buffer that a data over- 
run has occurred. This option is useful when the sampling process is not 
driven by clock overflows. 

As with the first option, a data overrun causes a data-overrun indicator 
to be stored in the data buffer, and the sweep-status word returns an 
error code. (See Appendix A of the REAL-lllMNC Programmer's 
Reference Manual.) However, unlike the first option, this option allows 
the sweep to continue, and the data-overrun indicator is placed in the 
data buffer whenever a data overrun occurs. (See below.) 

3. Ignore all data overruns. This choice, which slightly enhances speed, is 
nonetheless dangerous because you may lose data without any indica- 
tion that it has been lost. 
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The system prompts you with one question at a time. If you respond to the 
first question with Y, the system does not ask the other two. If you respond 
to the first question with N and the second with Y, the system does not ask 
the third. The dialog reads as follows: 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
AN ANALOG INPUT SWEEP ("ADSWP")? 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESSC Y/N] : Y 

2) INDICATE DATA DMERRUN BY A PREDETERMINED BIT PATTERN IN THE DATA 
BUFFERCY/NlsN 

3) IGNORE DATA OMERRUNSCY/N] :N 

You must respond with Y to one of these quesions. If you respond to all 
three with N, the system responds as follows: 

YOU MUST ANSWER " Y " TO ONE OF THE QUESTIONS! 

It then repeats the first question. 

If you select the second option, the MNCGEN dialog also requests that you 
specify a numeric value that the system can return to you as a signal 
indicating a data overrun has occurred. This value should be an unlikely 
input value and one that you can easily recognize as an indicator and not a 
datum in the data buffer. 

MNCGEN asks: 

WHAT MALUE SHOULD BE USED TO INDICATE AN ANALOG DATA-OUERRUN? 
C0!0-177777]:37777 

Tip: The four leftmost bits in the data buffer (bits 15 to 12) are used to 
indicate gain and type of input. Therefore, you could choose a data-overrun 
value that does not match, in these four bits, the quantity being measured 
in the experiment. 

Once you have supplied this value, MNCGEN adds the following comment: 

NOTE! THIS UALUE WILL ALSO BE USED TO REPORT 
" ( I ) ADINP" . "ADFAST" t AND "ADSUM" ERRORS. 

If you are using the ADINP subprogram and you do not select the second 
option for handling data overruns, the software returns a value of 37777 
(octal) to indicate an error. If you are using the ADINP subprogram and 
you do select the second option, the value you specify in the question above 
is the value returned to indicate an error. 
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A.3.8 Specifying l\/INCKW-Related Information 

The REAL-11/MNC software can support one or two MNCKWs. However, 
in applications that require two MNCKWs, the operations performed by 
each MNCKW are distinct and separate. Before responding to MNCGEN 
questions regarding MNCKWs, therefore, you should know the different 
ways in which the two MNCKWs are used. 

In general, the first MNCKW (associated with the CLOCKA subprogram) 
is used for clock-driven sampling and for gathering data for time-interval 
histograms. This MNCKW is referred to as the "primary" clock, or 
MNCKW #0 in this MNCGEN procedure. 

The second MNCKW (associated with the CLOCKB subprogram) is used to 
maintain a software fine-resolution time base that supports time-stamping 
operations. This MNCKW is referred to as the "secondary" clock, or 
MNCKW #1 in this MNCGEN procedure. 

When two MNCKWs are used, the primary clock must be installed to the 
left of the secondary clock, and to the right of any MNCAD that may be 
present. As the MNCGEN dialog warns, if this convention is not observed, 
the software will malfunction, causing unpredictable results. 

For details regarding one-MNCKW and two-MNCKW configurations, re- 
fer to the REAL-lllMNC Programmer's Reference Manual and the 
DECLAB-11/MNC User's Guide. 

The MNCGEN dialog prompts you as follows: 

HOW HANV MNCKWs ARE CONTAINED IN YOUR TARGET SYSTEM? CD!0-2:!2 

If you answer 0, the following REAL-11/MNC subprograms are not in- 
cluded in the resulting MNCLIB library: 

CLOCKA, CLOCKB, and GTHIST. 

(See Chapter 6 in the REAL-lllMNC Programmer's Reference Manual for 
information on these subprograms.) In addition, any requests for clock- 
driven sweeps will result in an error. The dialog now begins the section on 
information related to the MNCDI. 

If your answer to this question is not 0, the system requests a vector ad- 
dress and a CSR address for each MNCKW, as follows: 

WHAT IS THE UECTOR ADDRESS OF MNCKW 1*0? [ i 120-474 ]: 440 

WHAT IS THE CSR ADDRESS OF MNCKW «0? [0 s 1 71000- 171400] : 17 1020 

MNCGEN then asks if you want to include the GTHIST subprogram in 
your library. This subprogram collects data for time-interval histograms. 
Because of the size of this subprogram and because it is not required for 
many applications, you can omit it. If you do not intend to use GTHIST, 
respond with N to the following question: 
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DO YOU WANT THE "GTHIST" SUBPROGRAM IN YOUR LIBRARY7C Y/N3 : Y 

You also have the option to exclude from your customized library the capa- 
bility of performing clock-driven data transfers through several 
MNC-series modules operating in parallel. This feature requires additional 
software overhead, even when an operation activates only one clock-driven 
sampling sweep. Therefore, if your application does not require parallel 
clock-driven sampling through several MNC-series modules, omit this fea- 
ture by responding with N to the following question: 

DO YOU REQUIRE PARALLEL CLOCK-DRIMEN TRANSFERS THROUGH SEVERAL 
HNC-SERIES MODULES?CY/N]:l\l 

A.3.9 Specifying JVINCDI-Reiated Information 

The REAl^ll/MNC software supports a maximum of eight MNCDIs. You 
indicate how many MNCDIs you plan for your target system by responding 
to the following question: 

HOW MANY MNCDIs ARE CONTAINED IN YOUR TARGET SYSTEM7CD s 0-8] : 8 

If you answer 0, the REAL-11/MNC subprogram DIGO is not included in 
the resulting MNCLIB library. Furthermore, any call to DISWP, DINP, or 
MDISET will produce an error message that indicates a needed device is 
not present. The dialog now proceeds to the section on information related 
to the MNCDO. 

The software identifies each MNCDI by a unit number. The software as- 
signs the unit numbers according to the order in which you supply vector 
addresses and CSR addresses for the MNCDIs in responding to the 
MNCGEN questions. For example, assume that you have responded with 2 
to the question shown above. MNCGEN then requests two sets of addresses, 
one set for MNCDI #0 and one set for MNCDI #1. 

WHAT IS THE MECTOR ADDRESS OF MNCDI aO? CO : 120-474 ]: 120 

WHAT IS THE CSR ADDRESS OF MNCDI #0?C0 : 1 71 000- 1714003 : 1 71 1 BO 

WHAT IS THE MECTOR ADDRESS OF MNCDI «l?Ca : 120-474] ; 130 

WHAT IS THE CSR ADDRESS OF MNCDI «1?[0 : 171000- 1 714003 : 171 170 

Because data overruns can occur in digital-input sweeps, MNCGEN asks 
how you want the software to handle such data overruns. The options are 
identical to those mentioned earlier regarding input from A/D sweeps (see 
Section A. 3. 7). You must respond with Y to one of the following questions: 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OUERRUNS DURING 
A DIGITAL-INPUT SWEEP ("DISWP")? 

1) IMMEDIATELY TERMINATE THE SAMPLING PRDCESSE Y/N] : Y 

2) INDICATE DATA OUERRUN BY A PREDETERMINED BIT PATTERN IN THE DATA 
BUFFER [Y/N] :N 

3) IGNORE DATA DMERRUNS[Y/N]!N 
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As with A/D sweeps, if you select the second option, you must specify a 
numeric value that will appear in a data buffer to indicate the occurrence of 
a data overrun. This value should be one that you can easily recognize as 
an indicator and not a datum. 

WHAT VALUE SHOULD BE USED TO INDICATE A DIGITAL DATA OMERRUN? 
C0!0-177777]:177777 

Tip: Each bit in the data word is associated with an input line. If any input 
line is not used to indicate a datum, then set to 1 the bit corresponding to 
that line as an indicator of a data-overrun condition. If there is a known 
range of valid data, you can also choose a value outside that range to 
indicate the data-overrun condition. 

A.3.10 Specifying IVINCDO-Related Information 

The REAL^ll/MNC software supports a maximum of eight MNCDOs. 
With the exception of questions related to data overruns, the MNCGEN 
questions for MNCDOs are identical to those asked for MNCDIs (see 
Section A.3.9). As with MNCDIs, the software recognizes each MNCDO by 
a unit number that you assign according to the order in which you supply 
addresses for the MNCDOs in response to MNCGEN questions. 

The questions read as follows: 

HOW MANY MNCDOs ARE CONTAINED IN YOUR TARGET SYSTEM? [D : 0-8] s 8 

If you answer 0, any call to DOUT and DOSWP will produce an error 
message that indicates a needed device is not present, and the dialog pro- 
ceeds to the section on information related to the MNCAA. 

WHAT IS THE UECTOR ADDRESS OF MNCDO »0?[ ! 120-474 ] 5 SaO 

WHAT IS THE CSR ADDRESS OF MNCDO »0? CO s 171000- 17 1400 ]: 17 12G0 

A.3.11 Specifying IVINCAA-Related Information 

The REAL-11/MNC software supports a maximum of eight MNCAAs. You 
indicate the number of MNCAAs for your target system by responding to 
the following MNCGEN question: 

HOW MANY MNCAAs ARE CONTAINED IN YOUR TARGET SYSTEM?CD s 0-8 ] : 8 

Each MNCAA has four channels for output. The software addresses a par- 
ticular channel on a particular MNCAA according to global channel num- 
bers. The software assigns these numbers according to the order in which 
you supply CSR addresses for the MNCAAs. (For example, the first 
MNCAA has channels to 3, the second has channels 4 to 7, and so forth.) 

To indicate the CSR address for each MNCAA, respond to the following 
question, once for each MNCAA: 
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WHAT IS THE CS.R ADDRESS OF MNCAA «G?[0 : 171 000- 1 71^003 : 1 71060 

If you answer 0, the REAL-11/MNC subprograms DASWP and AOUT are 
not included in the resulting MNCLIB library file. 

A.3.12 Specifying SLU-Related Information 

The REAL-11/MNC software supports up to 20 SLU ports, Serial Line 
Units dedicated to instruments. These ports are contained in the DLVllJ 
module(s) in the restricted part of the MNC chassis. The standard MINC 
hardware configuration contains four SLUs; one for the console, one for a 
serial line printer, and two for instruments. You may not use an SLU that 
is being used for the RT-11 multi-terminal support option. 

HOW MANY SLUs IN YOUR TARGET SYSTEM WILL BE DEDICATED 
TO INSTRUMENTS?[DsO-20]:Z 

Each Serial Line Unit input channel uses an internal ring buffer for 
storage of input data. This data is entered into the buffer asynchronously; 
your program removes data from the buffer. Therefore, the larger the size 
of the buffer, the less frequently your program must remove data from it. 
The size of the buffer should be at least as large as the longest message that 
your program will read, and it must be an even number. 

WHAT IS THE SIZE» IN BYTES » OF THE INPUT RING BUFFER 
FOR EACH CHANNEL? [0:32-1024]: 82 

Each Serial Line Unit output channel uses an internal ring buffer for 
storage of data to be transmitted. This buffer can be smaller than the 
length of the largest message; however, the larger the buffer, the less fre- 
quently your program must remove data from it. 

WHAT IS THE SIZE. IN BYTES. OF THE OUTPUT RING 
BUFFER FOR EACH CHANNEL?[D : 16- 10243 : 40 

In the software, an SLU is identified by a unit number. The software as- 
signs these numbers according to the order in which you provide the vector 
and CSR addresses. If you have only one DLVllJ module, obtain the SLU 
vector and CSR addresses from the DECLAB-lllMNC User's Guide. If you 
have more than one DLVllJ module, obtain the SLU vector and CSR ad- 
dresses from DIGITAL. 

WHAT IS THE UECTOR(recv) ADDRESS OF SLU #0? CO : 120-3703 : 300 

WHAT IS THE CSR( recM) ADDRESS OF SLU «0? 
[0:160000-1777703:176500 

WHAT IS THE yECTOR(recM) ADDRESS OF SLU »1? [0:120-3703:310 

WHAT IS THE CSR(recy) ADDRESS OF SLU «1? 
[0:160000-1777703:176510 
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Data overrun occurs when the system cannot transfer data at the rate 
requested. It is not detected until the sampling process has begun. Three 
methods of handling this situation are available in REAL-11/MNC for se- 
rial I/O (CIN/COUT). You must select one. 

These methods are: 

1. Immediately terminate the sampling process when data overrun is de- 
tected. This is the usual way to handle the problem. 

2. Indicate by a predetermined bit pattern in the data buffer that a data 
overrun has occurred. This method is useful when the sampling process 
is not clock driven. 

3. Ignore all data-overrun conditions. This is a fast but dangerous choice 
since data may be lost with no indication. 

HDW DO YOU WANT REAL-11/MNC TO HANDLE DATA OyERRUNS DURING A SERIAL 
INPUT SWEEP 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESSC Y/N] ! Y 

2) INDICATE DATA OVERRUN BY A PREDETERMINED BIT PATTERN IN THE DATA 
BUFFER[Y/N]:N 

3) IGNORE DATA OyERRUNSCY/N3 ! N 



Phase 1 of the MNCGEN procedure ends after you have supplied informa- 
tion related to the SLUs. To indicate the end of Phase 1, MNCGEN prints 
the following message at the terminal: 

#*##**»#***»«** END REAL-11/MNC GENERATION PHASE 1 ***#*»*#»*##*** 



A.4 The MNCGEN Procedure: Phase 2 

The objective of Phase 2 of MNCGEN is to assemble the source files distrib- 
uted with your REAL-11/MNC software, together with the source file cre- 
ated in Phase 1. The resulting object files are used to create a new 
REAL-11/MNC library file called MNCLIB.OBJ. This file is customized to 
match your target configuration according to the answers you supplied in 
Phase 1. 

Unless you indicated in Phase 1 that you wanted to postpone the assembly 
process, MNCGEN immediately begins Phase 2 after Phase 1 ends. 

If you indicated in Phase 1 that you wanted to postpone the assembly pro- 
cess, you can complete Phase 2 at the time you select by executing one of 
the following indirect command files: 

MNCNOL.BLD Use this file if you do not want listings of your assem- 
bled files. 

MNCLST.BLD Use this file if you do want listings of your assembled 
files. 
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These indirect command files are supplied with your distributed 
REAL-11/MNC software. Though run at a later time, these files require 
the device assignments that you specified in Phase 1 (see Section A.3!3). 
For example, you must have assigned the new MDSC.MAC file created 
during Phase 1 to the device named N. 

To indicate the beginning of Phase 2, MNCGEN prints the following mes- 
sage at the terminal: 

**»«*#***####*# REAL-ll/MNC RT GENERATION PHASE 2 **#*****#****** 

To indicate the end of Phase 2, MNCGEN prints the following message at 
the terminal: 

#**#**##***#* END REAL-ll/MNC RT GENERATION PHASE 2 #*#******##** 

When Phase 2 has ended, you can link your new REAL-ll/MNC library 
file with the object file of your FORTRAN IV program(s). 



A.5 Sample MNCGEN Dialogs 

This section provides three sample MNCGEN dialogs. All three dialogs 
result in the generation of exactly the same REAL-ll/MNC library. How- 
ever, each uses a different form that demonstrates various features of the 
MNCGEN procedure. 

• The first sample demonstrates the use of the expanded, or long, form of 
the MNCGEN dialog. 

• The second sample demonstrates the use of the short form of the 
MNCGEN dialog. 

• The third sample demonstrates the "help" feature and various nonfatal 
error reports, which are usually caused by inappropriate responses to 
MNCGEN questions. 

A.5.1 Sample MNCGEN Dialog: Long Form 

The sample MNCGEN dialog given below demonstrates use of the ex- 
panded (or long) form of the dialog. 

• DATE 20-AIJG-81gED 

♦ TIME 10M5(Rl|) 

♦ ASSIGN DLO: N(RET) 
.ASSIGN DLi: I(Rn) 

• ASSIGN DLi: Ei(RET) 

»RUN i:mncgen(ret) 

REAL-11/MNC/RT SOFTWARE GENERATION PROCEDURE 
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J********** REAL-11/MNC GENERATION PHASE 1 **:«******* 

The system time is 10M5;29 

» 

The system date is 20-AUe-81 

Some additional information concerning this procedure and its 
effects is svai.lable in Apr-endi;-! A of theRT-11/FEP 3nd RT-ll/FRP 

1 1 1 VI 1 3 ]. 1 s t i o n a n d User's G u i d e , 

You can select cfither an expsnded form or s short form of this 
dialoaue. The expanded foriri explains each step in this <3ener- 
ation procedure. The short form> on the other hand? does not 
explain any ouestion. Howeverr if wou do not select the expand- 
ed form and do not understand a particular wuestion? resr-ond with 
"H" for help. This response will cause the expanded comment far 
that particular Question to be printed. 

DO YOU WANT THE MNCGEN DIALOGUE IN THE EXPANDED F0RM?CY/N::M Y (RET) 

This procedure is executed in two phases. The end result is a new 
file containina s library of the REAL-11 software routines which 
has been tailored to your system configuration. This file can be 
used as is» or added to an existing library file. See Appendix A 
of the RT~11/FEP and RT-11/FRP Installation and User's Guide 
for further information. 
The purposes of the two phases of this procedure are' 

a) In Phase 1. to create a NEW file called "MDSC.MAC'f which symbol- 
ically describes the conf iaurat ion of the MNC-series modules for 
your target system. Phase 1 also creates a verification prosramj 
"MyERN.FOR'f which is tailored specifically to your conf isuration. See 
Appendix A of the RT-11/FEP and RT-11/FRP Installation and User's Guide 
for software verification instructions, 

b) In Phase 2» to create a NEW library file called 'MNCLIB.OBJ" » 
usina the description provided in Phase 1 of this procedure. 

The new file contains the customized REAL-11 software that matches 
aour taraet hardware configuration and software needs. 

Phase 1 of the feneration procedure consists of a series of ctuestions 
that you may answer in one of three ways, 

1) With "Y" or 'H' r to indicate yes or no. These ouestions usually 
concern features of this procedure or of the REAL-11/MNC software. 

2) With a decimal number. These ouestions usually pertain to the 
number of certain hardware items. 

3> With an octal number. These Questions usually concern the vector 
and control-status-resiister (CSR) addresses of the MNC-series 
modules. 

Terminate all answers by striking the RETURN key (<RET>). 

Each Question in the dialogue is followed by an acceptable r.snse of 
answers. This ranse is indicated by values enclosed within souare 
brackets. If the range is given in octal > indicated bw an 'Of pre- 
ceding the actual range* then your response must also be an octal 
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value. If the ranSe is aiven in decimsli' indicated tv^i 3 "Dt" precaii- 
ind the actual ran^e? then your resi='onse must also he s decimal value. 
Following the ranSe is the resf-onse that the procedure will us© 
if Hou respond to a auestion bu tyFin£i only a FiETURN. 

examples: CY/N3:Y => ranse is Y or N? default is Y 

I:d:0-8D;1 => ranae is decimal to 8» default is 1 

COJ 130-4741; 130 => rani^e is octal 130 to 474 J def-sult is 130 

The following is a list of reoui rements that MUST be satisfied beroi'i? 
the sof tware-aenerat ion procedure can function properlwl 

1) You must have made a copy of your distributed REAL-11/MNC software 
and your latest MDSC.MAC MNC-ser ies-module descriptor file. 

2) You must have assigned the name "D" to the device that cont,.^:ins the 
copy of MDSC.MAC to be used in this procedure for the default an- 
swers. This file is usually the distributed file MDSCMACt or the 
latest one created ba a previous execution of Phase 1 of the <3ene ra t lan 
procedure. You can assisin a logical name to a physical device 

by usina the RT-ll "ASSIGN" command. 
EXAMPLE! .ASSIGN DLO B 

3) You must have assigned the name "N" to the device that will contain 
the NEW files MDSC.MACj and MyERN.FOR. When Phase 2 is executed* 
MNCLIB.OBJ will also be directed to this device. 

N0TE5 This device* in Phase 2» will also be used for intermediate 

file storage. IiependinS on the attributes of the REAL-11/MNC 
software beina created? between 150 and 350 blocks of 
CONTIGUOUS storaae space are reauired. 

When Phase 2 of this procedure is executed* the following additional 
rectui rements applaS 

4) You must have assigned the name "I" to the device that contains a 
COPY of the distributed REAL-11/MNC software. 

5) If you intend to Set assembly listinss of the REAL-11 files* you 
must assian the name "L" to the device that will receive your 
listing files. 

CAUTION. NEW files created on a device having OLD files with the seme 
names REPLACE the old files. Therefore* devices "I" and "D" 
should differ from device "N". 

HAVE YOU MET THE REQUIREMENTS TO PERFORM THIS PROCEDURE?C Y/N3 5 N y (RET) 

The software-generation procedure is performed in two phases* 

1) In Phase 1* a new MDSC.MAC file is created on device "N". This 
file symbolically represents the configuration of MNC-series 
modules of your tarSet system and any optional software support 
that you have selected during the feneration dialogue. 

2) Through a lengthy assembly process* a new REAL~11/MNC library 
file* MNCLIB.OBJ* is created* which reflects the description sfiven 
in Phase 1 of your configuration of MNC-series modules and software 
rectui rements . 
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You mau perform this second phase indepernJentla at some other time. 
To do so aou roust execute the indirect command file " MNCNOL . BLD " 
if aou do not want sssembla listinsSs of the REAL-U source files» or 
the indirect command file ' MNCLST. BLD ' if you do want li«tirifi3s. 
Both files are part of your REAL-1. 1/MNC software distribution kit. 

These command files assume that device names "I'r "N'j 3nd» if 
reouiredj "L" have been assigned exactly as if the second phase were 
beins performed as part of this current procedure. 

If you decide to perform Phase 2 at a later tiiner be sure that the 
file MDSC.MACf created durin-S Phase 1 of this procedurey is on dpvicc 
•N" . 

SHOULD THIS PROCEDURE EXECUTE PHASE 2?i:: Y/N] : Y ® 

The software-deneration procedure involves the assembly of many MACRO 
source files. These sources are uncommented » and the resultinsi 
listing files are many and lengthy. 

Therefore r in generals you should NOT choose to obtain listinsi files. 
DO YOU WANT TO PRODUCE ASSEMBLY LISTING FILESTC Y/N1 t N (RET) 



If this system is the target system for the REAL-11/MNC software and 
if the MNC-series modules are presently installed, then the procedure 
will verify that your responses match the installed hardware. 

caution: This additional checking feature reauires that your sy'stem 
be used solely for this procedure during Phase 1. 

IS THIS SYSTEMr AS PRESENTLY CONFIGURED, THE TARGET SYSTEM OF THIS 
MNC6EN PR0CEDURE?CY/N:] JN Ydj) 

Selecting the following feature allows the REAL-11 software to 
check for the presence of reouired devices when a program is run. 
If selected* when s device reouired for a REAL-11 procedure is not 
present in the system (for example, an MNCAD is reouired for the 
ADSWP routine), an error code is returned to the calling program. 
If this feature is not selected, a system error results when a 
program reouiring a missing device is run. Such an error causes 
control to return to the system monitor. 

Although this feature is convenient, it is very costly in terms 
of the software overhead reouired to support it. Thus, if your 
hardware configuration does not change vera often, or if users of 
the software are fairly familiar with the hardware renuired to use 
the various parts of REAL-11. it is recommended that this feature 
not be included in your REAL-11 software, 

DO YOU WANT THE REAL-U SOFTWARE TO MAKE RUN-TIME CHECKS 
FOR THE PRESENCE OF REQUIRED LAB MODULES? CY/NJrrSIl) 
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*«*******« MNCAD-RELATED INFORMATION ********** 

The REAL-11/MNC software csn support one MNCAD having up to 64 
input channelsf sinale-ended or dif f erent i 3l f connected to it. 

HOW MANY MNCADs ARE CONTAINED IN YOUR TARGET SYSTEM?CIi : 0-1 3 n(REI) 

The vector address of each MNCAD is determined by the state of e bank 
of switches located on the module* The factory switch settings usu- 
ally correspond to the default responses provided in this dialogue. 
Howevem information re<33rdin^ the chansinsi or verification of these 
switch settings is provided in the DECLAB-1 1/MNC user's '^uide, 

WHAT IS THE VECTOR ADDRESS OF MNCAD *0?C0 M 20-474.1 : 400(011) 

The CSR address of each MNCAD is determined by the state of a bank 
of switches located on the module. The factory switch settings usu- 
ally correspond to the default responses provided in this dialogue. 
Howeverr information regarding the chansiina or verification of these 
switch settings is provided in the DECLAB-il/MNC user's ^uide. 

WHAT IS THE CSR ADDRESS OF MNCAD *0?C0 : 1 71000-171 400 3 : 1 71 000 glT) 



The MNCAG module allows variable Sain settinsis for input on ariy 
of the A/D channels with which it is associated. An MNCAG can 
be associated with a block of four channels on either an MNCAD 
or an MNCAM. 



DOES YOUR TARGET SYSTEM CONTAIN AN MNCAGTC Y/N3 : Y (RET) 



If your system has an MNCAG assciated with any MNCADj wou will have to 
inform the A/D subprograms of aour desired aain value when sampling 
the affected channels. This value may be defaulted when a subprogram 
is called* and the front-panel Sain-selector switch on the MNCAG is 
set to 3 fixed ^ain. In this case the hardware determines the <J3in 
selections. 

However* if the Sain-selection switch is set to " F" r for proSrammsblef 
the subproarsms need to be 'told s default aain value to use. 

The following response will define what ^ain value is to be used in 
that situation. 

WHAT SHOULD BE THE DEFAULT GAIN VALUE WHEN THE GAIN-SELECTION SWITCH 

ON AN MNCAG IS SET TO PROGRAMMABLE?: 

.5(0)» 5(1). 50(2)» OR 500(3)? CD : 0-33 : (reT) 

The MNCTP module allows ANSI standard type thermocouples to be 
connected to the A/D. 

DOES YOUR TARGET SYSTEM CONTAIN AN MNCTP?C Y/N3 1 Y (HD 



REAL-1 1/MNC Software Generation Procedure A-21 



•Data overrun" occurs when the sustein c3nnot transfer data at the rate 
reauested. It is not detected until the sampling process has begun. 
Three methods of handling this situation are available in REAL-11/MNC 
for analoa-input sweeps <AEiSWP). You must select one. 

These methods srei 

1) Immediately terminate the sampling process when data overrun is 
detected. This is the usual way to handle the problem. In fact» 
this is the only way that REAL-11/MNC handles data overruns for 
all clock-driven sweeps involvinis any device except the MNCAD. 

2) Indicate in the data buffer* via a bit pattern (numeric value) 
to be defined later? when a datum was missed durints the ssdip 1 i n;.i 
process. This method is useful when the sampling process is not 
clock driven. 

3) lanore all data-overrun conditions. This is a fast but (..len;^erous 
choice since data may be lost with rio indication. 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
AN ANALOG INPUT SWEEP CADSWP")? 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESSC Y/N3 : Y N(RET) 

2) INDICATE DATA OVERRUN BY A PREDETERMINED BIT PATTERN IN THE 
DATA BUFFERCY/NJtN Y(rei) 

The bit pattern? put in a data buffer to indicate the occurrence of 
3 data-overrun condition? should be a numeric value that is a very 
unlikely input value. Thus this value will be easily recoi^niaed 
later as an indicator and not a datum. 

WHAT VALUE SHOULD BE USED TO INDICATE AN ANALOG DATA OVERRUN'? 
C0:0-1777773537777 (RET) 

note: THIS VALUE WILL ALSO BE USED TO REPORT 
"(DADINP"? "ADFAST'r AND "ADSUM" ERRORS. 



id********* MNCKW-RELATED INFORMATION ********** 

The REAL-11/MNC software can support one or two MNCKWs. However? if 
two MNCKWs are installed? each is used by the software to perform 
separate and distinct functions. MNCKW #0 described in this procedure 
is referred to as the "primary" clock. It is used for clock-driven 
sampling or for Satherins time-interval histosram data. MNCKW #1 
described in this procedure is referred to as the "secondary" clock. 
It is used by the software to maintain a fine-resolution software time 
base? which may be used to time stamp asynchronous digital input. 

Note? If two MNCKWs are present in your system? the primary module 
must be installed to the LEFT of the secondary module and to 
the RIGHT of any MNCADs. If this convention is not observedip 
the software will malfunction? causing unpredictable results. 
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HOW MANY MNCKUs ARE CONTAINED IN YOUR TARGET SYSTEMTCD : 0-2:.l 52 gg) 

WHAT IS THE VECTOR ADDRESS Of- MNCKW *0?C0 : 120 -474 3 M40 gg) 

WHAT IS THE CSR ADDRESS OF MNCKW *0?L0 : 171000-1 71 4003 H. 71020 (ret) 

WHAT IS THE VECTOR ADDRESS OF MNCKW *1?C0 1 1 20-4743 : 450 (reTI 

WHAT IS THE CSR ADDRESS OF MNCKW *1?L0 t 171000-1 71 4003 J 1 71024 (gg) 

The subprogram "GTHIST'j which collects time- interval histo^rsm d3t3» 
is an optional subproaram. Because of its ^izer you may choose to 
exclude it from your library. If aou do not intend to use "GTHIST'i 
respond with "N" to the following Question. 

DO YOU WANT THE "GTHIST' SUBPROGRAM IN YOUR l.IBRARYTC Y/N3 : Y (RET) 

It is possible to allow the software to perform clock-driven I/O 
through several different MNC-series modules in parallel. However? 
this feature reouires additional software overhesdf even when onlt* 
3 single clock-driven transfer subroutine is active. Therfore? if 
you do not reauire parallel clock-driven transfers throusih several 
MNC-series modulesf do not include this fe<?turG in your library. 



DO YOU REQUIRE PARALLEL CLOCK-DRIVEN TRANSFERS THROUGH SEVERAL 
MNC-SERIES M0DULES?CY/N3:N(REI) 



1HLtt****t* MNCDI-RELATED INFORMATION ********** 

The REAL-11/MNC software supports up to eiaht MNCDIs, These modules 
should be located to the riaht of any MNCADs. In the software* an 
MNCDI is identified by a 'unit number". The software assigns these 
nuMbers according to the ORDER in which you provide the vector and 
CSR addresses. 

HOW MANY MNCDIs ARE CONTAINED IN YOUR TARGET SYSTEMTCD 5 0-83 1 8 l(Rg) 

WHAT IS THE VECTOR ADDRESS OF MNCDI *0?C0 J 120-4743 J 120(RFD 

WHAT IS THE CSR ADDRESS OF MNCDI *0?C0 : 171 000-1714003 t 1 71 160(r|t] 

"Data overrun" occurs when the system cannot transfer data at the rate 
reauested. It is not detected until the sampling process has besiun. 
Three methods of handling this situation are available in REAL-11/MNC 
for diaital-input sweeps (DISWP) that are not driven by the clock 
(MNCKW). You must select one. 
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These methods 3reJ 

1) Immediately terminste the seitiF-linsi process when dsts overrun is 
detected. This is the usual way to handle the problem* In f5ct» 
this is the onlu way that REAL-11/MNC handles data overruns for 
all clock-driven sweeps involvinsi any device except the MNCAD, 

2) Indicate in the data buffer? vie a bit pattern (numeric value) 
to he defined later? when a datuin W3<ii missed durina the samplinsi 
process. This method is useful when the sampling process is not 
clock driven. 

3) Isfnore all data-overrun conditions. This is a fast but dan-serous 
choice since data may be lost with no indication. 

HOU DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
A DIGITAL INPUT SWEEP ("DISWP")? 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESS CY/N J S Y (RET) 



********** MNCDO-RELATED INFORMATION ********** 

The REAL-11/MNC software supports up to eight MNCDOs. These modules 
should be located to the riiSht of any MNCADs. In the software? an 
MNCDO is identified by a "unit number". The software assigns these 
numbers according to the ORDER in which you provide the vector and 
CSR addresses. 

HOW MANY MNCDOs ARE CONTAINED IN YOUR TARGET SYSTEM?CD : 0-81 ! 8 KRET) 

WHAT IS THE VECTOR ADDRESS OF MNCDO *0?i:0 .' 120-474D : 340 ® 

WHAT IS THE CSR ADDRESS OF MNCDO #0?C0 : 171000-1714003 : 171260 (H) 



********** MNCAA-RELATED INFORMATION ********** 

The REAL-11/MNC software will support up to eight MNCAAs. Each 
module has four channels for output. The software will address a 
particular channel on a particular module via a global channel-number 
assignment. The software makes this assignment in accordance with the 
ORDER in which your supply the CSR addresses for the modules. The 
software assigns channel numbers 0-3 to the first MNCAA described? 
channel numbers 4-7 to the second MNCAA? and so forth. 

HOW MANY MNCAAs ARE CONTAINED IN YOUR TARGET SYSTEMTCD : 0-83 : S 1® 
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WHAT IS THE CSR ADHRESS OF MNCAA *0?C0 : 171000-- 1 71 400D : 1 71060 (RET) 



*)K)K******* SLU-RELATED INFORMATION Jt:********* 



The REAL-11/MNC software supports up to 20 SLU 
Serial Line Units (ports) dedicated to instruments. 
These ports are contained in the DLVllJ module<s) in 
the restricted part of the MNC chassis. The standard 
MINC hardware conf isiuration contains 4 SLUs? one for 
the console* one for a serial line printer? and two 
for instruments. In the software r an SI..U is 
identified by a unit rigmher. The software 
assigns these numbers according to tlie ORDER in which 
you provide the vector and CSR addresses. 

You may not use a SLU that is concurrently bein.'sl used 
for system terminal support or for a serial line 
printer. 



HOW MANY SLUs IN YOUR TARBET SYSTEM WILL BE IiFniCATED 
TO INSTRUMENTS?Crr;0-20D J 2 3 (RU 



Each Serial Line Unit input channel uses an internal 
rina buffer for storasle of input data. This data 
is entered into the buffer asynchronously 5 your program 
removes data from the buffer. Therefore? the larger the; 
size of the buffer? the less freauentla your prosSram must 
remove dats from it. The size of the buffer should be at 
least 3S l3rde as the the longest mess3<3e that your 
prosfram will read? and it must be an even number. 



WHAT IS THE SIZE? IN BYTES? OF THE INPUT RING BUFFER 
FOR EACH CHANNEL? CD:32-10243: 82 (r!t) 



Each Serial Line Unit output channel uses an internal 
rinsi buffer for storage of data to be output. This 
buffer can be smaller than the lenath of the largest 
inessade? however? the larSer the buffer? the less 
freauentlt:> aour program must enter data into it. 



WHAT IS THE SIZE? IN BYTES? OF THE OUTPUT RING 
BUFFER FOR EACH CHANNEL?CD: 16-10243 J 40 @!t) 

WHAT IS THE VECTOR(recv) ADDRESS OF SLU * 0?C0: 120-3703 : 300 (RET) 

WHAT IS THE CSR(recv) ADDRESS OF SLU * 0?C0 J 160000-1777703 5 176500 ® 
*N0TE- the transmit CSR? 176504 and vector 304 are actually bein^ checked 

WHAT IS THE VECTOR(recv) ADDRESS OF SLU * 1?C0J 120-3703 : 310 (rS) 
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WHAT IS THE CSR<recv) ADDRESS OF SLU * 1?C0 1 1 60000-1 777703 : 1 76510 EH) 
*NOTE- the transmit CSRir 176514 end vector 314 are sctuslla beins checked 

WHAT IS THE VECTOR<recv) ADDRESS OF SLU * 2?C0 ; 120-3703 5 ;520 (RET) 

WHAT IS THE CSR<recv) ADDRESS OF SLU # 2? CO : 160000-1777703 : 176520 HI) 
*NOTE- the transmit CSRn 176524 and vector 324 3re ectuaHy beinS checke'd 

'Data overrun' occurs when the system cannot transfer data at th« rate 
rectuested. It is not detected until the saniplins process has be<3un» 
Three methods of handling this situation are available in REAL-11/MNC 
for serial I/O (CIN/COUT). You must select one. 

These methods areJ 

1) Immediately terminate the sampling process when date overrun is 
detected. This is the usual way to handle the problem. 

2) Indicate in the data hufferr via a bit pattern (numeric value) 
to be defined laterr when a datum was missed durina the ssmplind 
process. This method is useful when the sampling process is not 
clock driven. 

3) Idnore all data-overrun conditions. This is 3 fist but dansierous 
choice since data may be lost with no indication. 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
A SERIAL INPUT SWEEP 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESSC Y/N3 5 Y (HS) 



*****«#*** END REAL-11/MNC GENERATION PHASE 1 ********** 

STOP -- 

.SET TT QUIET 

********** REAL-11/MNC RT GENERATION PHASE 2 ********** 
The system time is 10;49J35 
The system date is 20-AUG-81 



ERRORS DETECTED} 

ERRORS DETECTED} 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 
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ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 



detected; 
detected: 
detected} 
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detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
detected: 
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detected: 
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detected; 
detected: 
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detected: 
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detected: 
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ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected; 







ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected: 







ERRORS 


detected: 







ITEMPL 








ITEMPF 








IWHICH 








yOLTS 








CELSIU 








CONVER 








PSCLKA 








PSHIST 








PSCLKB 








PSAD 








PSD I 








PSDO 








PSDA 








PSSL 








.MAIN. 








TFORTRAN-I-C.MAIN 


.D Errors: 0» Wsminds* 



«*))(******* END REAL-11/MNC RT GENERATION PHASE2 ********** 
The sustem time is li:ii:08 

The system d3te is 20-AU6~81 
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A.5.2 Sample MNCGEN Dialog: Short Form 

The sample MNCGEN dialog given below demonstrates use of the short 
form of the dialog. The resulting library is identical to the one created by 
the dialog given in Section 3.5.1. 



. DATE 20-AUG-81(Rgl 
.TIME 10:45@ET) 
.ASSIGN DLO: NgET) 

• ASSIGN DLi: Ign) 

• ASSIGN DLi: Ii(RET) 

• RUN IIHNCGENglT) 

REAL-U/MNC/RT SOFTWARE GENERATION PROCEDURE 

********** REAL-n/MNC GENERATION PHASE 1 ********** 
The system time is 10:45:22 
The system date is 20-AUG-8i 



Soiiie additional information concerning this procedure and its 
effects is available in Appendi;; A of the RT-ll/FEP and RT-11/FRP 

1 1 1 ri 1 3 1 1 B t i D ri 3 n d User's G u i d e » 



You can select either an expanded form or a short form of this 
dialogue. The expanded form explains each step in this gener- 
ation procedure. The short foriru on the other hand? does not 
explain any Question. Howeverr if you do not select the expand- 
ed form and do not understand a particular ouestionr resr-ond with 
"H" for help. This response will cause the expanded comment for 
that particular Question to be printed. 

DO YOU WANT THE MNCGEN DIALOGUE IN THE EXPANDED FORMTC Y/N3 t N (RET) 

HAVE YOU MET THE REQUIREMENTS TO PERFORM THIS PROCEDURE?: Y/NH : N Y(REI) 

SHOULD THIS PROCEDURE EXECUTE PHASE 2?CY/N3:Y(1t) 

DO YOU WANT TO PRODUCE ASSEMBLY LISTING FILESTC Y/N.] : N © 

IS THIS SYSTEMf AS PRESENTLY CONFIGURED, THE TARGET SYSTEM OF THIS 
MNCGEN PR0CEDURETCY/N3JN Y® 

CAUTION* This additional checkinS feature reauires that your system 
be used solely for this procedure durinsi Phase 1. 

DO YOU WANT THE REAL-11 SOFTWARE TO MAKE RUN-TIME CHECKS 
FDR THE PRESENCE OF REQUIRED LAB MODULES? CY/N3:Y(RH) 
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IK********* MNCAIi-RELATED INFORMATION ***#****** 

HOW MANY MNCADs ARE CONTAINED IN YOUR TARGET SYSTEMTCD 1 0-1 3 : 1 (RET) 

WHAT IS THE VECTOR ADDRESS OF MNCAD ♦O'i'C : 120-4743 : 400 (RET) 

WHAT IS THE CSR ADDRESS OF MNCAD #0?C;0 : 171000-1 71 4003 : 1 71 000 © 

DOES YOUR TARGET SYSTEM CONTAIN AN MNCAGTC Y/N3 ! Y (RET) 

WHAT SHOULD BE THE DEFAULT GAIN VALUE WHEN THE GAIN-SELECTION SWITCH 

ON AN MNCAG IS SET TO PROGRAMMABLE? 2 

.5(0). 5(1). 50<2)t OR 500(3)? CD 5 0-33 : (RET) 

DOES YOUR TARGET SYSTEM CONTAIN AN MNCTR?C Y/N3 J Y (RET) 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
AN ANALOG INPUT SWEEP CADSWP")? 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESSC Y/N3 t Y N(1t) 

2) INDICATE DATA OVERRUN BY A PREDETERMINED BIT PATTERN IN THE 
DATA BUFFERCY/N3 5N YdJ 

WHAT VALUE SHOULD BE USED TO INDICATE AN ANALOG DATA OVERRUN? 
C0J0-1777773:37777 (M) 

note: THIS VALUE WILL ALSO BE USED TO REPORT 
"(DADINP'f "ADFAST'r AND "ADSUM" ERRORS* 



********** MNCKW-RELATED INFORMATION ********** 

HOW MANY MNCKWs ARE CONTAINED IN YOUR TARGET SYSTEM?CD J 0-23 : 2 (13 

WHAT IS THE VECTOR ADDRESS OF MNCKW *0?C0 J 120-4743 5 440 (REjl 

WHAT IS THE CSR ADDRESS OF MNCKW *0?L0 1 171000-1714003 : 1 71020 (H) 

WHAT IS THE VECTOR ADDRESS OF MNCKW *1?C0 : 120-4743 t 450 ® 

WHAT IS THE CSR ADDRESS OF MNCKW #1?C0; 171000-1714003 5 171024 (M) 

DO YOU WANT THE "GTHIST" SUBPROGRAM IN YOUR LIBRARY?C Y/N3 1 Y (M) 

DO YOU REQUIRE PARALLEL CLOCK-DRIVEN TRANSFERS THROUGH SEVERAL 
MNC-SERIES M0DULESTCY/N3SN m) 
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iK********* MNCDI-RELATED INFORMATION *****iK*!K)|(* 

HOW MANY MNCDIs ARE CONTAINED IN YOUR TARGET SYSTEMTCD : 0-83 1 8 1 (reJ 

WHAT IS THE VECTOR ADDRESS OF MNCDI #0?CO : 120-4743 1 120 (ret) 

WHAT IS THE CSR ADDRESS OF MNCDI *0?[:0 : 171000-1714003 : 171 160 (RET) 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
A DIGITAL INPUT SWEEP CDISUP")? 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESSC Y/N3 J Y (RET) 

********** MNCDO-RELATED INFORMATION ********** 

HOW MANY MNCDOs ARE CONTAINED IN YOUR TARGET SYSTEM7CD : 0-83 : 8 i(ret3 

WHAT IS THE VECTOR ADDRESS OF MNCDO *0?C0 : 1 20-4743 t 340 @ 

WHAT IS THE CSR ADDRESS OF MNCDO *0?i:0 J 171000-1 714003 : 1 712A0 (Rg) 

********** MNCAA-RELATED INFORMATION ********** 

HOW MANY MNCAAs ARE CONTAINED IN YOUR TARGET SYSTEMTCD J 0-83 58 i (Rg) 

WHAT IS THE CSR ADDRESS OF MNCAA *0?C0: 171000-1714003 5 1 71060 (RET) 

********** SLU-RELATED INFORMATION ********** 



HOW MANY SLUs IN YOUR TARGET SYSTEM WILL BE DEDICATED 
TO INSTRUMENTS?CD:0-203: 2 3@ 

WHAT IS THE SIZE, IN BYTES, OF THE INPUT RING BUFFER 
FOR EACH CHANNEL? CD532-10243J 82 (r|j| 

WHAT IS THE SIZE, IN BYTES, OF THE OUTPUT RING 
BUFFER FOR EACH CHANNEL7CD : 16-10243 : 40 (RET) 
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WHAT IS THE VECTOR(recv) AUDRESS OF SLU * 0?C0 ; 120-3703 : 300 dB 

WHAT IS THE CSR(recv> ADDRESS OF SLU * 0?C0 : 160000-1 777703 : 176500 (H) 
*NOTE- the transmit CSRj 176504 and vector 304 are actually beins! checked 

WHAT IS THE VECTOR(recv) ADDRESS OF SLU ♦ 1?C0 5 120-3703 : 310 (Hi 

WHAT IS THE CSR<recv> ADDRESS OF SLU # l?tO } 160000-1777703 : 176510 dl) 
*N0TE- the transiriit CSRj 176514 and vector 314 are actually taeinS checked 

WHAT IS THE VECTOR(recv) ADDRESS OF SLU * 2?C0 : 120-3703 : 320 ® 

WHAT IS THE CSR(recv) ADDRESS OF SLU # 2?i:0 J 160000-1777703 : 176520 (ES) 
*N0TE- the transmit CSR» 176524 and vector 324 are actually beins checked 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
A SERIAL INPUT SWEEP 

1) IMMEDIATELY TERMINATE THE SAMPLING PROCESS: Y/N3 : Y (M) 



**t******* END REAL-11/MNC GENERATION PHASE 1 t*********; 

STOP -- 

.SET TT QUIET 

********** REAL~11/MNC RT GENERATION PHASE 2 ********** 
The system time is 10546J55 



The systeBi date is 20-AUG-81 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 
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ERRORS DETflCTflU: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected; 

ERRORS detected; 

ERRORS detected; 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

erI^ors detected: o 

ERRORS detected; 

errors detected: o 

ERRORS detected: 

errors detected; o 

ERRORS detected: 

errors detected; o 

errors detected; o 

errors detected; o 

ERRORS detected; 

errors detected; o 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected; 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected; 

ERRORS detected: 

ERRORS detected: 
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ERRORS DETECTED J 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 
itempl 

ITEMPF 
IWHICH 
VOLTS 

celsiu 

CONVER 

PSCLKA 

PSHIST 

PSCLKB 

PSAD 

PSD I 

PSDO 

PSDA 

PSSL 

.MAIN. 

TFORTRAN-I-C.MAIN.D Errors: 0, Warnings: 1 



**)K*#**)K** END REAL-11/MNC RT GENERATION PHASE2 iK********* 
The ssstem time is li:ii:08 

The sastem date is 20-AUG-81 
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A.5.3 Sample MNCGEN Dialog: Correcting Dialog Input Errors 

The sample MNCGEN dialog given below demonstrates how to use the 
"help" feature to recover from errors made in responding to MNCGEN 
questions. It also selects and performs Phase 2 as a separate operation. The 
resulting library, however, is identical to the one created by the examples 
given in Sections 3.5.1 and 3.5.2. 

. DATE 20-AUG-81(REl) 
. TIME 10:45(RE5 
. ASSIGN DLO: NIRET) 
. ASSIGN DLl ; I (RET) 
. ASSIGN DLi: DgD 
. RUN I ; MNCGEN (RET) 

REAL-11/MNC/RT SOFTyARE GENERATION PROCEDURE 

********** REAL-11/MNC GENERATION PHASE 1 ********** 
The system time is 10!45J16 
The system date is 20-AUG~81 

Some sdditicnsl inf ormat i on conce rni nss this procedure and its 
effects is svsilsble in Ar-pendi); A of the RT~11/FEP snd RT-11/FRP 
Instsl lation and User's Guide, 

You c 3 n select either an e x p 3 ri d e d form or ,i short f o r ro of t h i ?; 

dislosiije. The expanded form explains each step in this denei 

3tion procedure. The short fonii» on the other hsndj doeii not 
explain any ouestion. Hoyeverj if you do not selecl, the expand-- 
ed form snd do not understsnd a particular suestionj lespond with 
"H" for help. This response will cause the expanded coiiiiri>sni for 
that particular Question to be printed. 

DO YOU WANT THE MNCGEN DIALOGUE IN THE EXPANDED FORM'?C Y/N!] : N q (ret) 

**ERROR** 

RESPONSE IS SYNTACTICALLY INCORRECT! 

DO YOU WANT THE MNCGEN DIALOGUE IN THE EXPANDED F0RM?CY/N3:N h(1t) 

You can select either an expanded form or a short form of this 
dialogue. The expanded form explains each step in this fener- 
ation procedure. The short form» on the other hand? does not 
explain any Question. However* if you do not select the expand- 
ed form and do not understand a particular auestionj respond with 
"H" for help. This response will cause the expanded comment for 
that particular Question to be printed. 
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DO YOU WANT THE MNCGEN DIALOGUE IN THE EXPANDED FORMTC Y/N] : N (H) 

HAVE YOU MET THE REQUIREMENTS TO PERFORM THIS PROCEDURE?: Y/N.1 : N Y (RB) 

SHOULD THIS PROCEDURE EXECUTE PHASE 2?C Y/N] J Y (H) 

DO YOU WANT TO PRODUCE ASSEMBLY LISTING F ILES?C Y/N .1 5 N (H) 

IS THIS SYSTEMf AS PRESENTLY CONFIGURED. THE TARGET SYSTEM OF THIS 
MNCGEN PR0CEDURE?CY/N3:N Y (RET) 

caution: This additional checking feature renuires that your system 
he used solely for this procedure durins^ Phase 1. 

DO YOU WANT THE REAL-11 SOFTWARE TO MAKE RUN-TIME CHECKS 
FOR THE PRESENCE OF REQUIRED LAB MODULES? tY/N3:Y N (RET) 

*#*****)!(** MNCAD-RELATED INFORMATION ********** 

HOW MANY MNCADs ARE CONTAINED IN YOUR TARGET SYSTEM7CD : 0- 1 3 : 1 (RET) 

WHAT IS THE VECTOR ADDRESS OF MNCAD *0?C0 J 1 20-4743 : 400 488(RET) 

**ERROR** 

RESPONSE IS SYNTACTICALLY INCORRECT! 

WHAT IS THE VECTOR ADDRESS OF MNCAD tOrCO : 1 20-4743 : 400 (RCTI 

WHAT IS THE CSR ADDRESS OF MNCAD *0?C0 : 171000-1 714003 I 1 71000 171020gEI) 

**ERROR** 

THE ATTEMPT TO SIMULATE AN INTERRUPT USING CSR ADDRESS 171020 FAILED. 

WHAT IS THE VECTOR ADDRESS OF MNCAD *0? CO } 120-4743 : 400 © 

WHAT IS THE CSR ADDRESS OF MNCAD *0?C0 ! 171000-1 714003 : 171000 (RfT) 
DOES YOUR TARGET SYSTEM CONTAIN AN MNCAG?C Y/N3 t Y (RET) 

WHAT SHOULD BE THE DEFAULT GAIN VALUE WHEN THE GAIN-SELECTION SWITCH 

ON AN MNCAG IS SET TO PROGRAMMABLE?: 

.5<0), 5(1)» 50<2). OR 500(3)? CD : 0-33 1 0® 

DOES YOUR TARGET SYSTEM CONTAIN AN MNCTP?C Y/N3 : Y (HD 
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HOU DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURIN(3 
AN ANALOG INPUT SWEEP ('ADSWP')? 



1) IMMEDIATELY TERMINATE THE SAMPLING PROCESS [Y/N!] : Y n (RET) 

2) INDICATE DATA OVERRUN BY A PREDETERMINED BIT PATTERN IN THE 
DATA BUFFERCY/N]:N Y(Rg) 

WHAT VALUE SHOULD BE USED TO INDICATE AN ANALOG DATA OVERRUN? 
CO : 0-1 777773: 37777 @|5 

note: THIS VALUE WILL ALSO BE USED TO REPORT 
"(I)ADINP', 'ADFAST', AND "ADSUM" ERRORS. 



********** MNCKU-RELATED INFORMATION ********** 

HOW MANY MNCKUs ARE CONTAINED IN YOUR TARGET SYSTEMTTD ! 0--2 J : 2 3 (reJ 

**ERROR** 

RESPONSE IS OUT OF RANGE! 

HOW MANY MNCKWs ARE CONTAINED IN YOUR TARGET SYSTEM?CD J 0-23 : 2 1 (RET) 

WHAT IS THE VECTOR ADDRESS OF MNCKW *0?C0 : 120-4743 : 440 (Rg) 

WHAT IS THE CSR ADDRESS OF MNCKW *0?C0 : 171000-1714003 : 171 020 171000glT) 

**ERROR** 

ADDRESS GIVEN CONFLICTS WITH PREVIOUS RESPONSES. 

WHAT IS THE CSR ADDRESS OF MNCKW *0?C0 : 171000-1 71 4003 : 1 71 020 (ret) 

DO YOU WANT THE 'GTHIST' SUBPROGRAM IN YOUR LIBRARYTC Y/N3 : YfREj 

DO YOU REQUIRE PARALLEL CLOCK-DRIVEN TRANSFERS THROUGH SEVERAL 
MNC-SERIES M0DULES?CY/N3:N(re5 

********** MNCDI-RELATED INFORMATION ********** 

HOW MANY MNCDIs ARE CONTAINED IN YOUR TARGET SYSTEMTCD : 0-83 : 8 1 (ret) 

WHAT IS THE VECTOR ADDRESS OF MNCDI »0?C0 : 120-4743 : 120(re5 
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WHAT IS THE CSR AUDRESS OF MNCDI *0?C0 J 17 1000-1 71 4003 : 171 160 (RET) 



HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OVERRUNS DURING 
A DIGITAL INPUT SWEEP ("DISUP")? 



1) IMMEDIATELY TERMINATE THE SAMPLING PROCESSC Y/N3 : Y (Rg) 



********** MNCDO-RELATED INFORMATION ********** 

HOW MANY MNCDOs ARE CONTAINED IN YOUR TARGET SYSTEM?C D 1 0-83 : 8 .--KRET) 

**ERROR** 

RESPONSE IS SYNTACTICALLY INCORRECT! 



HOW MANY MNCDOs ARE CONTAINED IN YOUR TARGET SYSTEMTCD : 0-83 : 8 1 (RET) 
WHAT IS THE VECTOR ADDRESS OF MNCDO *0?C0 : 120-4743 : 340 100® 



**ERROR** 

RESPONSE IS OUT OF RANGE! 



WHAT IS THE VECTOR ADDRESS OF MNCDO t0?C0 1 120-474 3 J 340 (RETI 

WHAT IS THE CSR ADDRESS OF MNCDO *0?C0 J 171000- 1 714003 : 1 71260 ® 



********** MNCAA-RELATED INFORMATION ********** 

HOW MANY MNCAAs ARE CONTAINED IN YOUR TARGET SYSTEMTCD 3 0-83 : 8 1 gfl) 

WHAT IS THE CSR ADDRESS OF MNCAA *0?i:0 : 1 71000-1 71400 3 ! 1 71060 (H) 



********** SLU-RELATED INFORMATION ********** 



HOW MANY SLUs IN YOUR TARGET SYSTEM WILL BE DEDICATED 

TO instruments?cd:o-203; 2 3(RE5 



WHAT IS THE SIZEf IN BYTES? OF THE INPUT RING BUFFER 
FOR EACH CHANNEL? CD:32-10243: 82 (RET) 
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WHAT IS THE SIZE, IN BYTES f OF THE OUTPUT RING 
BUFFER FOR EACH CHANNELTCD : 1,^,- 1 024 3 : 40( 



WHAT IS THE UECTOR < recv ) ADDRESS OF SLU ♦ 0?C0 ! 120-3 70 J ! 300 (RET) 

WHAT IS THE CSR<recv) ADDRESS OF SLU * 0?L0 5 160000-1 777703 : 176500 :176S10(RfD 

*NOTE- the transmit CSR> 176514 and vector 304 are actually beina checked 

**ERROR** 

SIMULATING AN INTERRUPT USING CSR ADDRESS 176514 

CAUSES AN INTERRUPT THROUGH VECTOR ADDRESS 314 

RATHER THAN THROUGH 304 AS UAS INDICATED 



WHAT IS THE yECTOR(recv) ADDRESS OF SLU * 0?C0 : 120-3703 : 300 (RET) 

WHAT IS THE CSR(recv) ADDRESS OF SLU * 0?C0 : 160000-1 777703 1 1 76500 (RET) 
*NOTE- the transmit CSR» 176504 and vector 304 are actually beina checked 

WHAT IS THE VECTOR(recv) ADDRESS OF SLU * 1?CD ! 120-3703 : 31 (RET) 

WHAT IS THE CSR(recv) ADDRESS OF SLU ♦ 1 TLO : 160000- 1 777703 : 1 76510 (RET) 
*NOTE- the transmit CSRj 176514 and vector 314 are actually beins checked 

WHAT IS THE yECTOR(recv) ADDRESS OF SLU # 2?C0 ! 120-3703 5 320 (RET) 

WHAT IS THE CSR(recv) ADDRESS OF SLU * 2?C0 ! 160000-177770 3 I 1 76520 (RET) 
*NOTE- the transmit CSR? 176524 and vector 324 are actually bein.<5 checked 

HOW DO YOU WANT REAL-11/MNC TO HANDLE DATA OUERRUNS DURING 
A SERIAL INPUT SWEEP 



1) IMMEDIATELY TERMINATE THE SAMPLING PROCESS tY/N3 t Y (RET) 



#*#******* END REAL-11/MNC GENERATION PHASE 1 ********** 



STOP 



********** REAL-11/MNC RT GENERATION PHASE 2 ********** 
The system time is 10J48;58 



The system date is 20-AU6-81 

ERRORS DETECTED? 

ERRORS DETECTED? 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 

ERRORS detected: 
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ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
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ERRORS 


detected; 
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detected; 
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detected; 
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detected: 
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ERRORS 


detected: 







ITEMF-L 








ITEMPF 








lUHICH 








VOLTS 








CELSIU 








CONVER 








PSCLKA 








PSHIST 








PSCLKB 








PSAD 








PSDI 








PSDO 








PSDA 








PSSL 








.MAIN. 








?FORTRAN-I-C.MAIN 


.3 Errors; 


» Wsminds; 



********** END REAL-ll/MNC RT GENERATION PHASE2 ********** 
The system time is li;ii;08 

The system dste is 20-AU6-81 
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A.5.4 Installing Generated REAL-11/MNC Software 

Before you verify REAL-11/MNC software that has been generated by the 
MNCGEN procedure, be sure the software is on the development system 
disk. If you did not specify the development system disk as device N: for the 
MNCGEN dialog, copy the REAL-11/MNC software to the development 
system disk by performing the following procedures: 

1. Bootstrap the development system disk in drive 0. 

Mount the disk that contains the generated REAL^ll/MNC software in 
drive 1. This disk is the one that was in device N: during the MNCGEN 
procedure. 

2. Copy the software by typing: 

.COPY di.i 1 iMNCLIB.OBJ duO s MNCL I B , OB JdB 

where dy is dl if you have two RL01/RL02 disks or dy if you have only 
RX02 diskettes. 

A.5.5 Verifying Generated REAL-11/MNC Software 

This section contains instructions for verifying REAL^ll/MNC software 
that you have generated by performing the REAL-11/MNC Software 
Generation Procedure (MNCGEN). For instructions on verifying distrib- 
uted REAL^ll/MNC software, see Section 4.2.3. 

To verify generated REAI^ll/MNC software: 

1. Be sure disks are in the same drives they were in during the MNCGEN 
procedure and that those drives still have the same logical device 
names they had during the MNCGEN procedure. Also be sure that 
device N: contains at least 100 contiguous free blocks; if necessary, use 
the SQUEEZE command to consolidate free space on device N:. 

2. The clock Schmitt triggers can generate outputs in response to electri- 
cal noise when no device is connected to the input. To avoid such spuri- 
ous responses from unused Schmitt triggers, set the mode selector of 
each MNCKW clock module to VAR and turn the associated potentiom- 
eter to either of its extreme settings. 

Also be sure no instruments are connected to the MNC-series modules. 

3. The verification procedure creates (and deletes) files named 
MVERN.OBJ and MTMP.RUN. Therefore, if you have any files with 
those names, rename them before you begin the verification procedure. 

4. You must be using the SJ or FB monitor when you execute the 
REAL-11/MNC verification procedure. You also must execute the pro- 
cedure on the system console terminal. 

5. Execute the verification procedure by typing: 

. @I :HNCLIB,yER(l!l 
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6. As the verification procedure tests the REAL-11/MNC software, it 
prints messages on the console terminal. The following list contains the 
types of messages and an example of each: 

• confirmation messages, which verify that an MNC-series module and 
some related REAL-11/MNC software have been exercised success- 
fully. For example: 

The primary clock (1st MNCKW) aind some related REAL-11 software 
have been exercised s u c c e s s f u 1 1 >• ! 

• level-W error messages, which indicate that hardware named in the 
message is absent. For example: 

?MMER-k-The REAL-11 software has NOT detected an analoS to 
digital input Module (MNCAD) in this system. 

• level-F error messages, which are fatal error messages indicating 
that the software has malfunctioned. One type of fatal error message 
names the verification module that has failed. For example: 

?MMER-F-REAL Software Error - Installation failure at PSDI 

Another type of fatal error message lists trouble-shooting aids for 
DIGITAL support personnel. For example: 

?MUER-F-*##UNEXPECTED ERROR DURING HNCAA RELATED PHASE#*# 
#**CHECK HARDWARE I/O SIGNALS*** 

Troub le-shoot ins aids for DEC supports 

a) IND = 1 

b) INFO(l) = 33a 

A third type of fatal error message indicates either that required 
MNC-series hardware is not present or that vector and/or CSR ad- 
dress switch settings do not agree with values you gave for those 
settings during the MNCGEN dialog. For example: 

?HyER-F-MNCAD CSR/UECTOR addressing probleiti 

• the completion message: 

STOP--MERIFICATION PROCESS COMPLETE 



7. When the console terminal displays the system dot, evaluate the results 
of the verification procedure: 

• If the terminal has displayed only a series of confirmation messages 
followed by the completion message, then the REAL-ll/MNC soft- 
ware and MNC-series hardware are correctly installed. 

• If the terminal has displayed any level-W messages, then 
MNC-series hardware is absent. If a level-W message names an 
MNC-series module that is present in your system, be sure that mod- 
ule's vector and CSR address switches are correctly set, then execute 
the verification procedure again. Ignore level-W messages that name 
MNC-series hardware not present in your system. 
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• If the terminal has displayed any level-F messages that indicate 
missing hardware or inaccurately set vector and/or CSR address 
switches, then again execute the MNCGEN procedure and install and 
verify the generated software. 

• If the terminal has displayed any level-F messages that indicate soft- 
ware malfunction, call the MING Product Services Center for further 
information. 

• If the terminal has displayed a series of messages but has not printed 
the completion message, then the software has malfunctioned; call 
the MINC Product Services Center for additional information. 

A.5.6 Adding a Library of Generated REAL-H/IVINC Software to 
SYSLiB 

When you have installed all needed FEP-11 software, see Section 5.6 for 
information on using the librarian to add files to SYSLIB. 
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Appendix B 

SYSGEN Answers that Will Duplicate the Installed 
XM Monitor 



The following page lists the SYSGEN answers that you can use to duplicate 
the XM monitor built by the SYSGEN option of the FEP Installation Disk. 
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1 


N 


40 


177170 


79 


skipped 


118 


skipped 


2 


N 


41 


264 


80 


skipped 


119 


skipped 


3 


N 


42 


skipped 


81 


skipped 


120 


skipped 


4 


N 


43 


skipped 


82 


skipped 


121 


skipped 


5 


Y 


44 


N 


83 


skipped 


122 


skipped 


6 


skipped 


45 


skipped 


84 


skipped 


123 


skipped 


7 


Y 


46 


skipped 


85 


skipped 


124 


skipped 


8 


skipped 


47 


skipped 


86 


skipped 


125 


skipped 


9 


N 


48 


skipped 


87 


skipped 


126 


skipped 


10 


N 


49 


skipped 


88 


N 


127 


skipped 


11 


N 


50 


N 


89 


Y 


128 


skipped 


12 


N 


51 


N 


90 


N 


129 


skipped 


13 


skipped 


52 


N 


91 


skipped 


130 


skipped 


14 


skipped 


53 


skipped 


92 


skipped 


131 


skipped 


15 


40 


54 


N 


93 


Y 


132 


skipped 


16 


134 


55 


skipped 


94 


176500 


133 


skipped 


17 


N 


56 


N 


95 


300 


134 


skipped 


18 


Y 


57 


Y 


96 


N 


135 


skipped 


19 


skipped 


58 


2 


97 


N 


136 


skipped 


20 


skipped 


59 


N 


98 


N 


137 


skipped 


21 


skipped 


60 


skipped 


99 


Y 


138 


skipped 


22 


N 


61 


N 


100 


N 


139 


skipped 


23 


N 


62 


N 


101 


skipped 


140 


skipped 


24 


Y 


63 


skipped 


102 


skipped 


141 


skipped 


25 


Y 


64 


skipped 


103 


skipped 


142 


skipped 


26 


N 


65 


skipped 


104 


10 


143 


skipped 


27 


N 


66 


skipped 
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skipped 


144 


skipped 


28 


Y 


67 


skipped 


106 


skipped 


145 


skipped 


29 


N 


68 


skipped 


107 


skipped 


146 


skipped 


30 


skipped 


69 


skipped 


108 


skipped 


147 


skipped 


31 


N 


70 


skipped 


109 


skipped 


148 


skipped 


32 


skipped 


71 


, skipped 


110 


skipped 


149 


skipped 


33 


skipped 


72 


skipped 


111 


skipped 


150 


skipped 


34 


skipped 


73 


skipped 


112 


skipped 


151 


skipped 


35 


skipped 


74 


skipped 


113 


skipped 


152 


DLl or DYl 


36 


skipped 


75 


skipped 


114 


skipped 


153 


DLO or DYO 


37 


Y 


76 


skipped 


115 


skipped 


154 


DLO or DYO 


38 


N 


77 


skipped 


116 


skipped 


155 


N 


39 


N 


78 


skipped 


117 


skipped 




- 
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Index 



Adding file protection, 2-9, 2-17, 3-5, 

3-10, 4-5 
Addresses, 

IBVll-A CSR, 4-11 

IBVll-A vector, 4-11 

MNCAA CSR, A-14 

MNCAD CSR, A-9 

MNCAD vector, A-9 

MNCDI CSR, A-13 

MNCDI vector, A-13 

MNCDO CSR, A-14 

MNCDO vector, A-14 

MNCKW CSR, A-12 

MNCKW vector, A-12 

MNC-series CSR, 4-6 

MNC-series vector, 4-6 

SLU CSR, A-15 

SLU vector, A-15 
ADINP, A-9 
ADSWP, A-9 

data overrun, 4r-7, A-10, A-11 
Alternate extended-memory overlay, 4—21 
ANSI mode, 8-1 to 8-3 
Assembly listings, A-7 
ASSIGN command, 

RT-11, 3-5, 3-11, 4-8, 4-14, 4-17, 4-24, 
A-6 
Assignments, 

device, 3-5, 3-11, 4-8, 4-14, 4-17, 4r-24, 
A-6 
AUTO XOFF/XON, 2-4, 5-1 
AUTOPATCH, 2-4, 2-9, 2-17, 3-4, 3-10 

Bad blocks, 3-4, 3-7, 3-9, 3-13 
BLODAT.OBJ, 7-1 
BREAK key, 2-5, 6-1 
Buffer, 

input ring, A-15 

output ring, A-15 



Choosing form of MNCGEN, A-3, A-4 
Clock, 

primary, A-12 

secondary, A-12 
CLOCKA, A-12 
CLOCKB, A-12 
Command, RT-11, 

ASSIGN, 3-5, 3-11, 4-8, 4-14, 4-17, A-6 

COPY, 3-7, 3-13, 4-8, 4-10, 4-11, 4-12, 
4-13, 5-7, A-42 

DELETE, 2-13, 4-18 

EDIT, 5-2, 5-3 

EXECUTE, 5-8 

FORMAT, 3-9, 4-4 

FORTRAN, 4-15, 5-3, 5-8 

FRUN, 6-7 

INITIALIZE, 2-11, 3-4, 3-7, 3-9, 3-13, 
4-4,4-5 

INSTALL, 4-12 

LIBRARY, 5-6, 5-7 

LINK, 5-4, 5-5, 6-7, 7-4 

LOAD, 4-12 

REMOVE, 4-11 

RENAME, 2-9, 2-17, 3-4, 3-5, 3-10, 
4-5 

RESUME, 6-8 

RUN, 5-8 

SET, 2-6, 5-2 

SQUEEZE, 3-4, 3-7, 3-9, 4-3, 4-15 

UNLOAD, 4-11 
Compiling a program, 5-3, 5-4, 5-8 
Completion routines, 6-2, 6-3 
Configurations, 

MNC-series, A-2, A-11 
Control Status Register (CSR), 

see CSR addresses 
COPY command, 

RT-11, 3-7, 3-13, 4-8, 4^10, 4-11, 
4-12, 4-13, 5-7, A-42 
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Copying a disk, 

with the FEP distribution disk, 2-7, 2-8 

with the FEP Installation Diskette, 
2-15, 2-16 
Correcting MNCGEN input errors, A-35 
Creating a program, 5-3 
CSR addresses, 

IBVll-A, 4-11 

MNCAA, A-14 

MNCAD, A-9 

MNCDI, A-13 

MNCDO, A-14 

MNCKW, A-12 

SLU, A-15 
CTRL/C, 

precaution when typing, 6-1 

Data overrun, 

ADSWP, 4-7, A-10, A-11 

DISWP, 4-7, A-13 

Serial I/O, A-15 
Default gain value, 4-7, A-9 
Default listing device, 2-23 
Default responses, 

MNCGEN, A-4, A-5 
DELETE command, 

RT-11, 2-13, 4-18 
Development system disk, 

contents of the RL01/RL02, 2-11, 2-12 

preserving the RL01/RL02, 3-7 
Development system diskette, 

contents of the RX02, 2-20 

preserving the RX02, 3-13 
Device assignments, 3-5, 3-11, 4-8, 4-14 

4-17, 4-24, A-6 
Device slots, 

RT-11, 2-24 
Dialog, 

sample MNCGEN, A-17 to A-41 
DIGO, A-13 
DINP, A-13 

Distribution media, 1-2, 1-3 
DISWP, A-13 

data overrun. A— 14 
DOSWP, A-14 
DOUT, A-14 

EDIT command, 

RT-11, 5-2, 5-3 
EDIT programs, 

RT-11, 5-2, 5-3 
Editors, 5-2, 5-3 
EIS, 3-5, 3-11, 4-17 



Errors, 

correcting MNCGEN input, A-35 
ERRTXT.TXT, 7-1 
Executable load module, 5-5, 5-8 
Executing a program, 5-8, 5-9 
Extended-memory -resident overlay, 4^21 



FB monitor, 2-6, 2-11, 2-14, 2-20, 2-22, 

3_3, 4_4, 4_7, 4-12, 6-1, 6-2 to 6-4 
FDT, 

distributed files, 4-18 

distribution media, 1-3 

installing, 4-18 to 4-20 

uses of, 1-2 

using, 5-8 

verifying, 4^19, 4-20 
FDT.MAC, 4-18 
FDT.OBJ, 4-18 
FDTVER.FOR, 4-18 
FEP Library Diskette, 4-4, 4-10, 4-13, 4-16, 

4-18, 4-20 
FEP/FRP, 

components of, 1-2 

distribution media, 1-2, 1-3, 4r-l 

hardware requirements, 1-2 

installing, 1-3, 4-1 to 4-35 

minimal software needed for installing, 
4-i 

patching, 4-1, 4r-5 

preparing to install, 4-3 to 4—5 
File storage, 

intermediate, 5-6, A-6 
Files, 

distributed FDT, 4-18 

distributed REAI^ll/MNC, 4-6, A-1, A-2 

protecting, 2-17, 3-5, 3-10, 4-5 

removing protection of, 2-17, 3-4, 
3-10, 4-5 
FIS, 1-1, 3-5, 3-6, 3-11, 3-12 
Foreground jobs, 

executing XM, 6-7, 6-8 

linking XM, 6-7, 6-8 
FORGEN dialog, 3-5 to 3-7, 3-10 to 3-13 
Form of MNCGEN, 

choosing, A-3, A-4 

expanded, A-3, A-4 

short, A-3, A-4 
FORMAT command, 

RT-11, 3-9, 4-4 
FORTRAN command, 

RT-11, 4-15, 5-3, 5-8 
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FORTRAN IV, 

building the compiler on RL01/RL02s, 3-5 

to 3-7 
building the compiler on RX02s, 3-10 to 

3-13 
building the OTS on RL01/RL02s, 3-5 to 
3-7 

building the OTS on RX02s, 3-10 to 3-13 
floating-point hardware and RL01/RL02s, 

3-5, 3-6 
floating-point hardware and RX02s, 3-11, 

3-12 
FORGEN dialog and RL01/RL02s, 3-5 to 

3-7 
FORGEN dialog and RX02s, 3-10 to 

3-13 
installing on RL01/RL02s, 3-1 to 3-7 
installing on RX02s, 3-8 to 3-13 
installing standard software, 3-1 
minimal software needed to install, 3-3 
OTSGEN dialog and RL01/RL02s, 

3-6, 3-7 
OTSGEN dialog and RX02s, 3-12, 3-13 
patching on RL01/RL02s, 3-4, 3-5 
patching on RX02s, 3-10 
preparing to install on RL01/RL02s, 3-3 
preparing to install on RX02s, 3-8, 3-9 
preserving the RL01/RL02 development 

system, 3-7 
preserving the RL01/RL02 distribution 

media, 3-4 
preserving the RX02 development system, 

3-13 
preserving the RX02 distribution media, 

3-9, 3-10 
RL01/RL02 distribution media, 1-2, 1-3 
RX02 distribution media, 1-2, 1-3, 3-9 
standard compiler, 1-3, 3-1 
standard OTS, 1-3, 3-1 
tailoring, 3-1 

testing on RL01/RL02s, 3-7 
testing on RX02s, 3-13 
FPU, 1-1, 3-6, 3-12 
FRUN command, 6-7 

Gain value, 

default, 4-7, A-9 
Gain-selection switch, 

MNCAG, A-9 
Global symbols, 5-5, 5-6 
GREEK character font, 7-1 
GREEK.Font, 7-1 
GTHIST, 4-7, A-12 



Hard-copy terminal, 

setting characteristics of, 5-2 

lADINP, A-8 

IB, 4-11, 4-12 

IB.SYG, 4-11 

IBLIB.OBJ, 4-10 to 4-13, 5-6 

IBMNC.SYS, 4-10, 4-11 

IBS, 

device handlers, 4-10 to 4^13 

distribution media, 1-2, 1-3 

hardware requirements, 1-2 

installing, 4-10 to 4-13 

library files, 4-10 to 4-13 

performing SYSGEN for, 4-11 

uses of, 1-2 

verifying, 4-13 

XM monitor and, 4-11, 4-12 
IBVll-A IEEE bus, 1-2, 4-11 

GSR address switch, 4-11 

vector address switch, 4-11 
IBXMNC.SYS, 4^10 
IEEE bus, 

see IBVll-A IEEE bus 
Indirect command file for 

program development, 5-9 to 5-13 
INITIALIZE command, 

RT-11, 2-11, 3-4, 3-7, 3-9, 3-13, 4-4, 4-5 
Initializing an RL01/RL02 disk, 2-11 
Initializing an RX02 diskette, 3-4, 3-7, 3-9, 

3-13, 4-4, 4-5 
Input ring buffer, A-15 
INSTALL command, 

RT-11, 4-12 
Installation, 

distributed REAL^ll/MNC, 4-6 to 4-10 

FDT, 4-18 to 4-20 

FEP/FRP, 1-3, 4-1 to 4-35 

FORTRAN IV on RL01/RL02s, 3-1 to 3-7 

FORTRAN IV on RX02s, 3-8 to 3-13 

generated REAL-11/MNC, A-42 to A-44 

IBS, 4r-10 to 4-13 

LSP, 4-16 to 4-18 

RGL/11, 4-20 to 4-35 

RT-11, 2-1 to 2-28 

SSP, 4-13 to 4-16 
Interactive procedure for 

program development, 5-9, 5-13 to 5-19 
Intermediate file storage, 5-6, A-6 
INTSET Interrupt Service Routine, 6-4 

KED, 2-11, 2-20, 5-2, 5-3 
.KSCT p-sects, 6-6 



Index-3 



Librarian, 5-5 to 5-7 
LIBRARY command, 

RT-11, 5-6, 5-7 
Line printer, 

parallel, 2-22, 3-3, 4-4 

serial, 2-22, 3-3, 4-4 
LINK command, 

RT-11, 5-4, 5-5, 6-7, 7-4 
Linker, 5-4, 5-5, 5-8, 6-4 to 6-8, 7-2 to 7-7 
Linking a program, 5-4, 5-5, 5-8, 6-4 to 6-8, 

7-2 to 7-7 
Linking a program that calls RGL/11 

software, 7-2 to 7-7 
Linking REAL-11/MNC subprograms, 

6-4 to 6-9 
Listing device, 

default, 2-23 
Listings, 

assembly, A-7 
LOAD command, 

RT-11, 4-12 
Load map, 6-6 

Locking USR into memory, 6-5 
LP.SYS, 2-11, 2-22, 3-3, 4-4 
LS.SYS, 2-11, 2-22, 3-3, 4r-4 
LSP, 

distribution media, 1-3 

hardware requirements, 1-2 

indirect command file, 4-16, 4-17 

installation options, 4—16 

installing, 4-16 to 4-18 

interactive build procedure, 4-16, 4—17 

uses of, 1-2 

verifying, 4-17 
LSPBLD.COM, 4-16, 4-17 
LSPCND.MAC, 4-16 
LSPMAK.SAV, 4-16 
LSPVER.COM, 4-16, 4-17 



MACRO assembler, 

deleting the, 4-1, 4-35 
MACRO.SAV, 4-35 
MADSTS, A-9 

MDSC.MAC, A-3, A-5, A-6, A-17 
Memory, 

locking USR into, 6-5 
MINC Product Services Center, 4-10, 

4-20, A-44 
MINC-11, 1-1 
MINC-23, 1-1 
MINC/DECLAB-23, 1-1 
Minimal software for installing FEP/FRP, 

4-4,4-5 



Minimal software for installing FORTRAN 

IV, 3-3 
MNCAA, 

CSR address, A-14 

specifications in MNCGEN, A-14 
MNCAD, 

CSR address, A-9 

specifications in MNCGEN, A-8 to A-11 

vector address, A-9 
MNCAG, 

gain-selection switch, A-9 

mode, A-9 
MNCAM, A-9 
MNCDI, 

CSR address, A-13 

specifications in MNCGEN, A-12, A-13 

vector address, A-13 
MNCDO, 

CSR address, A-14 

specifications in MNCGEN, A-13, A-14 

vector address, A-14 
MNCGEN, 

see REAL-11/MNC Software Generation 
Procedure 
MNCGEN.SAV, A-2 
MNCKW, 

CSR address, A-12 

mode, 4-8 

specifications in MNCGEN, A-12, A-13 

vector address, A-12 
MNCLIB.OBJ, 4-7, A-6, A-42 
MNCLST.BLD, A-7, A-16 
MNCMUL.OBJ, 4-6 to 4-8 
MNCNOL.BLD, A-7, A-16 
MNCSNG.OBJ, 4-6 to 4-8 
MNCTP, A-10 
MNC-series modules, 

configurations, A-2, A-8, A-11 

CSR addresses, 4-6, 6-1 

errors indicating missing, 6-14, 6-15 

run-time hardware checking of, A-8 

target system, A-8, A-12 

vector addresses, 4-6 
Mode, 

ANSI, 8-2, 8-3 

MNCAG, A-9 

SET-UP A, 2-4, 2-5 

SET-UP B, 2-4 

VT52, 5-1, 5-2, 8-1 to 8-3 
Monitor, RT-11, 

FB, 2-6, 2-11, 2-14, 2-20, 2-22, 3-3, 
4_4, 4_7, 4-12, 6-1 to 6-4 

SJ, 2-6, 2-11, 2-14, 2-20, 2-22, 3-3, 
4-4, 4-7, 4-12, 6-1 to 6-4 

XM, 2-23 to 2-28, 2-25, 6-3 to 6-9 
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MQ handler, 6-6 

MTMP.RUN, 4-9, A-42 

Multiple clock-driven sweeps, 4-6, 4-7, A-12 

MVERN.OBJ, 4-9, A-42 

OTSGEN dialog, 3-6, 3-7, 3-12, 3-13 
Output ring buflfer, A-15 
Overlays, 

and RGL/11, 4-21 to 4-23 
Overrun, 

ADSWP data, 4-7, A-10, A-11 

DISWP data, 4-7, A-13 

Parallel line printer, 2-22, 3-3, 4-4 
Parallel clock-driven transfers, 4-6, 4-7, 

A-13 
PDP-11/03, 1-1, 3-5, 3-6, 3-11, 3-12 
PDP-11/23, 1-1, 3-5, 3-6, 3-11, 3-12 
Phase 1 of MNCGEN, A-3, A-4, A-7, A-16, 

A-17 
Phase 2 of MNCGEN, A-3, A-6, A-7, A-16, 

A-17 
Placement requirements, 

hardware, A-12 
Planning for MNCGEN, 4-6, A-2, A-3 
PLOT55, 

using with a VT105, 5-1, 8-1 to 8-4 
Postponing Phase 2 of MNCGEN, A-7 
PREP.COM, 5-9, 5-10 
Preserving an RL01/RL02 development 

system disk, 3-7 
Preserving an RL01/RL02 distribution disk, 

3-4 
Preserving an RX02 development system 

diskette, 3-13 
Preserving an RX02 distribution disk, 3-9, 

3-10 
Privileged jobs, 6-5 
PRMLIB , 4-23 

Procedure for MNCGEN, A-2 to A-41 
Processor, 

bootstrapping, 2-5, 6-1 

halting, 2-5, 6-1 
Product Services Center, 

see MINC Product Services Center 
PROGD.FOR, 5-9, 5-13 to 5-19 
Program, 

compiling a, 5-3, 5-4, 5-8 

creating a, 5-3 

editing a, 5-3, 5-8 

executable load module, 5-5, 5-8 

executing a, 5-8, 5-9 

indirect command file for developing a, 
5-9 to 5-12 



Program (Cont.), 

interactive procedure for developing a, 5-9, 

5-13 to 5-19 
linking a, 5-4, 5-5, 5-8, 6-4 to 6-8, 
7-2 to 7-7 
Program-development aids, 5-9 to 5-19 
.PROTECT programmed request, 6-4 
Protecting files, 2-17, 3-5, 3-10, 4-5 
P-sects, 6-6 

QBUS INIT function, 6-1 
Question types, 

MNCGEN, A-4, A-5 

REAL-11/MNC, 

distributed files, 4-6, A-1, A-2 
distributed libraries, 4-6, 4-7 
distribution media, 1-3, A-1, A-2 
hardware requirements, 1-2 
installing distributed, 4-6 to 4—10 
installing generated, A-42 
linking, 6-4 to 6-8 
performance with the FB and XM 

monitors, 6-15 
precautions when using, 6-1 to 6-15 
selecting a library, 4-6, 4-7 
sweep-status word, 6-2 
uses of, 1-2 
using, 6-1 to 6-15 
verifying distributed, 4-8 to 4-10 
verifying generated, A-42 to A-44 
XM monitor and, 6-5 to 6-14 

REAI^ll/MNC Software Generation 
Procedure (MNCGEN), 
assigning device names, A-5, A-6 
choosing form of, A-3, A-4 
conflict in answers, A-5 
default responses, A-4, A-5 
executing the, A-3 
expanded form of, A-3, A-4 
help information, A-3, A-35 
input errors, correcting, A-35 
MNCAA-related questions, A-14, A-15 
MNCAD-related questions, A-9 to A-11 
MNCAG-related questions, A-9 
MNCDI-related questions, A-13, A-14 
MNCDO-related questions, A-14 
MNCKW-related questions, A-12, A-13 
MNCTP-related question, A-10 
Phase 1 of, A-3, A-4, A-7, A-16, A-17 
Phase 2 of, A-3, A-6, A-7, A-16, A-17 
planning for, 4-6, A-2, A-3 
postponing Phase 2 of. A— 7 
procedure for, A-2 to A-41 
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REAL-11/MNC Software Generation 

Procedure(MNCGEN) (Cont.), 

producing assembly listing files, A-7 

question types, A-4, A-5 

range for answers, A-4, A-5 

requirements for, A-5 to A-7 

run-time hardware checking, A-8 

sample dialogs, A-17 to A-41 

short form of, A-3, A-4 

SLU-related questions, A-15, A-16 

verifying generated software, 
A-42 tp A-44 
ReGis, 4-12 
REMOVE command, 

RT-11, 4-11 
Removing file protection, 2-17, 3-4, 

3-10, 4-5 
Removing global symbols, 5-5, 5-6 
RENAME command, 

RT-11, 2-9, 2-17, 3-4, 3-5, 3-10, 
4-5 
Requirements, 

for MNCGEN, A-5 to A-7 

hardware placement, A-12 
RESUME command, 6-8 
REXLIB, 4-23 
RGLINS, 4-24 
RGLINS.OVR, 4-24 
RGLLIB.OBJ, 4-23, 7-1 
RGLLNK, 4-26, 4-27, 7-2 
RGLVFl, 4-28 
RGLVF2, 4-28 
RGL/11, 

block data module, 7-1 

completing the installation of, 4-26, 4-27 

error messages, 7-1 

executing a program that calls, 7-7, 7-8 

files, 4^21 

Greek character font, 7-1 

installing, 4^20 to 4-35 

library, 4-23, 7-1 

linking a program that calls, 7-2, 7-7 

overlays, 4-21 

verifying, 4-25 to 4r-35 
RL01/RL02 disks, 

adding file protection, 3-5 

bad blocks, 2-11 

contents of distributed, 1-3 

development system disk contents, 
2-11, 2-12 

initializing, 2-11 

installing FORTRAN IV on, 3-1 to 3-7 

installing RT-11 on, 2-6 to 2-12, 

2-23 to 2-25 



RL01/RL02 disks (Cont.), 

preserving a non-system disk, 2-7, 2-8, 

3-9, 3-10 
preserving a system disk, 3-7 
removing file protection, 2-17, 3-4, 4-5 
SQUEEZE command and, 3-4 
storage capacity, 1-1 
using, 1-1, 1-2 
Routines, 

completion, 6-2, 6-3 
User Service (USR), 6-4, 6-5 
RT-11, 

ASSIGN command, 3-5, 3-11, 4^8, 

4-14, 4-17, A-6 
bootstrapping, 2-5 
compressing the disk, 2-23 
COPY command, 3-7, 3-13, 4-8, 4-10, 

4-11, 4-12, 4-13, 5-7, A-42 
customizing, 2—23 
DELETE command, 2-13, 4-18 
device drivers, 2-24 
device slots, 2-24 
distribution media, 1-3 
EDIT command, 5-2, 5-3 
edit programs, 5-2, 5-3 
EXECUTE command, 5-8 
FORMAT command, 3-9, 4-4 
FORTRAN command, 4-15, 5-3, 5-8 
FRUN command, 6-7 
INITIALIZE command, 2-11, 3-4, 3-7, 

3-9, 3-13, 4-4, 4-5 
INSTALL command, 4^12 
installing, 1-3, 2-1 to 2-28 
installing on RL01/RL02 disks, 

2-6 to 2-12, 2-23 to 2-25 
installing on RX02 diskettes, 2-13 to 2-22, 

2-26 to 2-28 
keyboard monitor commands, 2-28 
LIBRARY command, 5-6, 5-7 
LINK command, 5-4, 5-5, 6-7, 7-4 
LOAD command, 4-12 ' 

multi-terminal support, 2-28 
patching, 2-9, 2-10, 2-17 
preparing to install, 2-4 to 2-6 
preserving the RL01/RL02 distribution 

disk, 2-7, 2-8 
preserving the RX02 distribution disks, 

2-15, 2-16 
preserving the working system, 2-23 
REMOVE command, 4-11 
RENAME command, 2-9, 2-17, 

3-4, 3-5, 

3-lG, 4^5 
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RT-11 (Cont.), 

RESUME command, 6-8 
RUN command, 5-8 
SET command, 2-6, 5-2 
SQUEEZE command, 3-4, 3-7, 3-9, 

4-3, 4-15 
standard software, 1-3, 2-22 
system generation process, 

see SYSGEN 
testing the working system, 2-22 
UNLOAD command, 4-11 
RUN command, 

RT-11, 5-8 
RXOl diskettes, 

SYSGEN and, 2-28 
RX02 diskettes, 

bad blocks, 3-9, 3-13 
contents of distributed, 1-3 
development-system diskette contents, 

2-20 
device full, 2-13 
freeing space on, 2-13, 2-14 
initializing, 3-9, 3-13, 4-4 
installing FORTRAN IV on, 3-8 to 3-13 
installing RT-11 on, 2-13 to 2-22, 

2-26 to 2-28 
librarian and, 5-7 
preserving a non-system diskette, 3-9, 

3-10 
preserving a system diskette, 3-13 
removing file protection, 2-17, 3-10 
storage capacity, 1-1 
SQUEEZE command and, 3-9, 3-13 
SYSGEN and, 2-28 
using, 1-1, 1-2 
utilities diskette contents, 2-20, 2-22 

Sample MNCGEN dialogs, A-17 to A-41 
Schmitt trigger, 4-8, A-42 
Serial I/O, 

data overrun, A-15 

input ring buffer, A-15 

output ring buffer, A-15 
Serial line printer, 2-22, 3-3, 4-4 
Service Routines, 

User (USR), 6-4, 6-5 
SET command, 

RT-11, 2-6, 5-2 
SET TT NOP AGE, 2-6 
SET-UP A mode, 2-4, 2-5 
SET-UP B mode, 2-4 
Short form of MNCGEN, A-3, A-4 
SJ monitor, 2-6, 2-11, 2-14, 2-20, 2-22, 

3_3, 4_4, 4_7, 4_i2, 6-1 to 6-4 



SLU, 

GSR address, A-15 

specifications in MNCGEN, A-15, A-16 

vector address, A-15 
Specifications in MNCGEN, 

MNCAA, A-14 

MNCAD, A-9 to A-11 

MNCDI, A-13, A-14 

MNCDO, A-14 

MNCKW, A-12, A-13 

SLU, A-15 
Specifying value of gain, A-9 
SQUEEZE command, 

RT-11, 3-4, 3-7, 3-9, 4-3, 4-15 
SSP, 

compiling, 4—14 to 4-16 

data files, 4-13 

distribution media, 1-3 

hardware requirements, 1—2 

indirect command files, 4^13 to 4—16 

installing, 4-13 to 4^16 

preparing to add, 4-14 

source files, 4-13 

test programs, 4-15 

uses of, 1-2 

verification completion message, 4-15 

verification error messages, 4-15 

verifying, 4-14, 4-15 
STARTF.COM, 2-22, 2-23, 4-12 
STARTS.COM, 2-22, 2-23, 4-12 
Startup indirect command files, 

customizing, 2-23, 5-2 
STARTX.COM, 2-23, 4-12 
Status Register (GSR), 

Control, see GSR addresses 
Storage, 

intermediate file, 5-6, A-6 
Storage capacity, 

RL01/RL02, 1-1 

RX02, 1-1 
Sweeps, 

multiple clock-driven, 4-6, 4—7, A-12 
Sweep-status word, 6-2 
Switch, 

MNCAG gain-selector, A-9 
SYNCH ERROR, 6-2 
SYSGEN, 

answers that duplicate the 

installed XM monitor, B-1, B-2 

IBS and, 2-23, 2-24, 4-11 

nonstandard answers, 2-28 

performing, 2-23 to 2-28 

standard answers, 2-28 

with the FEP distribution disk, 2-23, 2-24 
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SYSGEN (Cont.), 

with the FEP installation diskette, 
2-26, 2-28 
SYSLIB.OBJ, 3-3, 3-6, 3-12, 5-4 to 5-7, 

8-4, A-44 
SYSMAC.SML, 4-35 
System, 

MNC-series target, A-8 

Target system, 

MNC-series, A-8 
Terminal, 

as default listing device, 2-23 

VT55, 8-1 

VT105, 8-1 to 8-3 

VT125, 1-2, 8-1 
Testing installed software, 

see Verification 
Text editors, 5-2, 5-3 
TMPSSP files, 4-15 
Transfers, 

parallel clock-driven, 4-6, 4—7, A-13 

UNLOAD command, 

RT-11, 4-11 
Utilities system diskette, 

contents of the RX02, 2-22 
User Service Routines (USR), 6-4, 6-5 

Vector addresses, 
IBVll-A, 4^11 
MNCAD, A-9 
MNCDI, A-13 
MNCDO, A-14 
MNCKW, A-12 
SLU, A-15 



Verification, 

distributed REAI^ll/MNC, 4^8 to 4-10 

FDT, 4-19, 4-20 

FORTRAN IV, 3-7, 3-13 

generated REAI^ll/MNC, A-42 to A-44 

IBS, 4-13 

LSP, 4-17, 4-18 

RGL/11, 4-25 to 4-35 

SSP, 4^14, 4-15 
Video terminal, 

setting characteristics of, 2-4, 2-5, 
5-1, 5-2 
Virtual jobs, 6-5 
Virtual overlays, 6-9 to 6-14 
V0EX1.F0R, 6-9, 6-10, 6-13, 6-14 
V0EX2.F0R, 6-10 to 6-12 
V0EX3.F0R, 6-10, 6-12, 6-13 
VTMODE routine, 8-3, 8-4 
VT52 mode, 5-1, 5-2, 8-1 to 8-3 
VT55 terminal, 8-1 
VT105 terminal, 

ANSI mode, 8-1 to 8-3 

changing the mode of, under 
program control, 8-2 to 8-4 

manually changing the mode of, 8-2 

SET-UP A mode, 2-4, 2-5 

SET-UP B mode, 2-4 

VT52 mode, 5-1, 5-2, 8-1 to 8-3 
VT125 terminal, 1-2, 8-1 

Word, 

sweep-status, 6-2 

XM monitor, 2-23 to 2-28, 2-25, 6-3 to 6-9 
background jobs, 6-6, 6-7 
foreground jobs, 6-7 to 6-9 
generating, 2-23 to 2-28 
REAL-11/MNC and, 6-5 to 6-14 
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